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 |