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)

こちらもご覧ください

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver