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