WdfDriverWdmGetDriverObject 関数 (wdfdriver.h)
[KMDF にのみ適用]
WdfDriverWdmGetDriverObject メソッドは、指定されたフレームワーク ドライバー オブジェクトに関連付けられている Windows ドライバー モデル (WDM) ドライバー オブジェクトへのポインターを取得します。
構文
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
パラメーター
[in] Driver
WdfDriverCreate または WdfGetDriver の以前の呼び出しからドライバーが取得したドライバーのフレームワーク ドライバー オブジェクトへのハンドル。
戻り値
WdfDriverWdmGetDriverObject は 、DRIVER_OBJECT 構造体へのポインターを返します。 ドライバー ハンドルが無効な場合、システムバグチェックが発生します。
注釈
WdfDriverWdmGetDriverObject メソッドが返すポインターは、フレームワーク ドライバー オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク ドライバー オブジェクトの EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。
例
次のコード例では、指定したフレームワーク ドライバー オブジェクトに関連付けられている WDM ドライバー オブジェクトへのポインターを取得します。
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdriver.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf) |