[KMDF にのみ適用]
WdfDeviceWdmGetDeviceObject メソッドは、指定したフレームワーク デバイス オブジェクトに関連付けられている Windows ドライバー モデル (WDM) デバイス オブジェクトを返します。
構文
PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
WDFDEVICE Device
);
パラメーター
Device
フレームワーク デバイス オブジェクトへのハンドル。
戻り値
WdfDeviceWdmGetDeviceObject は、DEVICE_OBJECT 構造体へのポインターを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
WdfDeviceWdmGetDeviceObject メソッドが返すポインターは、フレームワーク デバイス オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク デバイス オブジェクト EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。
例示
次のコード例では、デバイスの PDO と FDO を表す WDM デバイス オブジェクトへのポインターを含むトレース メッセージを作成します。
TraceEvents(
TRACE_LEVEL_INFORMATION,
AMCC_TRACE_INIT,
"PDO 0x%p, FDO 0x%p",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device)
);
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfdevice.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |