WdfDeviceWdmGetPhysicalDevice 関数 (wdfdevice.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfDeviceWdmGetPhysicalDevice メソッドは、デバイス スタックから物理デバイスの WDM PDO を取得します。

構文

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

戻り値

WdfDeviceWdmGetPhysicalDevice は、DEVICE_OBJECT構造体へのポインターを返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

呼び出し元がコントロール デバイス オブジェクトを提供する場合、WdfDeviceWdmGetPhysicalDevice は NULL を返します。

注釈

WdfDeviceWdmGetPhysicalDevice メソッドが返すポインターは、フレームワーク デバイス オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク デバイス オブジェクトの EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。

例

WdfDeviceWdmGetPhysicalDevice を使用するコード例については、「WdfDeviceWdmGetAttachedDevice」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)