WriteableBitmap.Lock メソッド

定義

更新のためにバック バッファーを予約します。

public:
 void Lock();
public void Lock ();
member this.Lock : unit -> unit
Public Sub Lock ()

次のコード例は、メソッドを使用してバック バッファーを予約する方法を Lock 示しています。

    // The DrawPixel method updates the WriteableBitmap by using
    // unsafe code to write a pixel into the back buffer.
    static void DrawPixel(MouseEventArgs e)
    {
        int column = (int)e.GetPosition(i).X;
        int row = (int)e.GetPosition(i).Y;

        try{
            // Reserve the back buffer for updates.
            writeableBitmap.Lock();

            unsafe
            {
                // Get a pointer to the back buffer.
                IntPtr pBackBuffer = writeableBitmap.BackBuffer;

                // Find the address of the pixel to draw.
                pBackBuffer += row * writeableBitmap.BackBufferStride;
                pBackBuffer += column * 4;

                // Compute the pixel's color.
                int color_data = 255 << 16; // R
                color_data |= 128 << 8;   // G
                color_data |= 255 << 0;   // B

                // Assign the color data to the pixel.
                *((int*) pBackBuffer) = color_data;
            }

            // Specify the area of the bitmap that changed.
            writeableBitmap.AddDirtyRect(new Int32Rect(column, row, 1, 1));
        }
        finally{
            // Release the back buffer and make it available for display.
            writeableBitmap.Unlock();
        }
    }

注釈

このメソッドは Lock 、ロック数をインクリメントします。 a WriteableBitmap がロックされている場合、レンダリング システムは、メソッドの呼び出しによって完全に WriteableBitmap ロック解除されるまで更新を Unlock 送信しません。

このメソッドを Lock 使用して、マルチスレッド実装をサポートできます。 これらのシナリオでは、UI スレッドはビットマップをロックし、バック バッファーを他のスレッドに公開します。 ワーカー スレッドがフレームを終了すると、UI スレッドは変更された四角形を追加し、バッファーのロックを解除します。

UI スレッドは、レンダリング スレッドがバック バッファーのロックを取得してフロント バッファーにコピーするときにブロックできます。 このブロックからの待機時間が長すぎる場合は、メソッドを TryLock 使用して短時間待機し、バック バッファーがロックされている間に UI スレッドのブロックを解除して他のタスクを実行します。

適用対象

こちらもご覧ください