[KMDF にのみ適用]
WdfDeviceWdmGetPhysicalDevice メソッドは、デバイス スタックから物理デバイスの WDM PDO を取得します。
構文
PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
[in] WDFDEVICE Device
);
パラメーター
[in] Device
フレームワーク デバイス オブジェクトへのハンドル。
戻り値
WdfDeviceWdmGetPhysicalDevice は、DEVICE_OBJECT 構造体へのポインターを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
WdfDeviceWdmGetPhysicalDevice 、呼び出し元がコントロール デバイス オブジェクト 指定した場合、NULL を返します。
注釈
WdfDeviceWdmGetPhysicalDevice メソッドが返すポインターは、フレームワーク デバイス オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク デバイス オブジェクト EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。
例示
WdfDeviceWdmGetPhysicalDevice 使用するコード例については、「WdfDeviceWdmGetAttachedDeviceを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfdevice.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |