EngLockDirectDrawSurface 関数 (winddi.h)

EngLockDirectDrawSurface 関数は、DirectDraw サーフェスのカーネル モード ハンドルをロックします。

構文

ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
  [in] HANDLE hSurface
);

パラメーター

[in] hSurface

ロックするサーフェスへのハンドル。

戻り値

EngLockDirectDrawSurface は 、成功時にサーフェス情報を記述する DD_SURFACE_LOCAL 構造体へのポインターを返します。 それ以外の場合は、Null ポインターが返されます。

解説

EngLockDirectDrawSurface を使用すると、ドライバー ライターは DirectDraw サーフェスをロックできます。 ハンドルをロックすると、同期された動作が保証され、システム内の他のスレッドによってハンドルが削除されなくなります。

現在、ドライバーは Direct3D テクスチャ リング インターフェイスからのみ DirectDraw サーフェス ハンドルを受け取ります。 したがって、テクスチャリングを実行するドライバーのみがテクスチャ サーフェスをロックする必要があります。

テクスチャリングが完了したら、 ドライバーは EngUnlockDirectDrawSurface を呼び出してロックされたハンドルを解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header winddi.h (Winddi.h を含む)
Library Win32k.lib
[DLL] Win32k.sys

こちらもご覧ください

DD_SURFACE_LOCAL

EngUnlockDirectDrawSurface