IWICBitmapLock

Lock メソッドをサポートするメソッドを公開します。

ビットマップ ロックは、単にビットマップ内への矩形のメモリ ウィンドウを抽象化したものです。最も単純なケースであるシステム メモリ ビットマップの場合、これは矩形の左上隅を指すポインターと stride 値にすぎません。

Lock メソッドによって設定された排他ロックと、関連付けられた IWICBitmapLock オブジェクトを解放するには、IWICBitmapLock オブジェクトに対して IUnknown::Release を呼び出します。

ロックされた矩形の幅と高さをピクセル単位で取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

メモリの stride 値へのアクセスを提供します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

stride 値は、ビットマップではなく IWICBitmapLock に固有である点に注意してください。 たとえば、ビットマップの同じ矩形に対する 2 回連続したロックでは、内部実装によっては異なるポインターと stride 値が返される場合があります。

ロックされた矩形内の左上のピクセルへのポインターを取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

このメソッドで提供されるポインターは、ロック自体の有効期間を超えて使用しないでください。

GetDataPointer は、マルチスレッド アパートメント アプリケーションでは使用できません。

例

次の例では、IWICBitmapLock が指すデータをゼロで埋めています。

    IWICImagingFactory *pFactory = NULL;
    IWICBitmap *pBitmap = NULL;

    UINT uiWidth = 640;
    UINT uiHeight = 480;
    WICPixelFormatGUID formatGUID = GUID_WICPixelFormat32bppARGB;

    WICRect rcLock = { 0, 0, uiWidth, uiHeight };
    IWICBitmapLock *pLock = NULL;

    HRESULT hr = CoCreateInstance(
        CLSID_WICImagingFactory,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_IWICImagingFactory,
        (LPVOID*)&pFactory
        );

    if (SUCCEEDED(hr))
    {
        hr = pFactory->CreateBitmap(uiWidth, uiHeight, formatGUID, WICBitmapCacheOnDemand, &pBitmap);
    }

    if (SUCCEEDED(hr))
    {
        hr = pBitmap->Lock(&rcLock, WICBitmapLockWrite, &pLock);

        if (SUCCEEDED(hr))
        {
            UINT cbBufferSize = 0;
            UINT cbStride = 0;
            BYTE *pv = NULL;

            // Retrieve the stride.
            hr = pLock->GetStride(&cbStride);

            if (SUCCEEDED(hr))
            {
                hr = pLock->GetDataPointer(&cbBufferSize, &pv);
            }
            if (SUCCEEDED(hr))
            {
                // Access the bitmap memory starting at pv, where
                // each row begins cbStride bytes after the start
                // of the preceding row.
            }

            // Release the bitmap lock.
            pLock->Release();
        }
    }

    if (pBitmap)
    {
        pBitmap->Release();
    }

    if (pFactory)
    {
        pFactory->Release();
    }

    return hr;

ロックされたピクセル領域のピクセル フォーマットを取得します。これは、ロックされた領域における 1 ピクセルあたりのバイト数を計算するために使用できます。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。