EngCreateDriverObj 関数 (winddi.h)

EngCreateDriverObj 関数は、DRIVEROBJ 構造体を作成します。

構文

ENGAPI HDRVOBJ EngCreateDriverObj(
  PVOID       pvObj,
  FREEOBJPROC pFreeObjProc,
  HDEV        hdev
);

pvObj

DRIVEROBJ 構造体によって追跡されるドライバーリソースへのポインター。リソースは、現在のクライアントプロセスに関連付けられています。

pFreeObjProc

pvObj が指すリソースを解放するドライバー指定のコールバック関数へのポインター。コールバック関数は次のように定義する必要があります。 ここで、pDriverObj は DRIVEROBJ 構造体を指します。

BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);

hdev

オブジェクトに関連付けられている物理デバイスへのハンドル。このパラメーターは、ドライバーの DrvCompletePDEV 関数によって受信される GDI ハンドルです。

戻り値は、関数が成功した場合に新しく作成された DRIVEROBJ 構造体を識別するハンドルです。それ以外の場合は 0 です。

この構造は、リソース割り当てプロセスが最初にクリーンアップされずに終了した場合に解放する必要があるデバイス管理リソースを追跡するために使用されます。

ドライバーは、 EngDeleteDriverObj を呼び出すことによって、DRIVEROBJ 構造体を明示的に削除できます。それ以外の場合、DRIVEROBJ を作成したプロセスが終了したときに pFreeObjProc が指す関数を呼び出して、エンジンによってリソースが解放されます。

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