WdfFdoInitWdmGetPhysicalDevice 関数 (wdffdo.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfFdoInitWdmGetPhysicalDevice メソッドは、デバイスの WDM 物理デバイス オブジェクト (PDO) を取得します。

構文

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

パラメーター

[in] DeviceInit

ドライバーが EvtDriverDeviceAdd コールバック関数から取得したWDFDEVICE_INIT構造体へのポインター。

戻り値

操作が成功した場合、メソッドは DEVICE_OBJECT 構造体へのポインターを返します。 それ以外の場合、メソッドは NULL を返します。

注釈

ドライバーは、WdfDeviceCreate を呼び出す前に WdfFdoInitWdmGetPhysicalDevice を呼び出す必要があります。 WdfDeviceCreate の呼び出しの詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。

WdfFdoInitWdmGetPhysicalDevice メソッドの詳細については、「関数ドライバーでのデバイス オブジェクトの作成」を参照してください。

例

次のコード例では、デバイスの WDM PDO を表すDEVICE_OBJECT構造体へのポインターを取得します。

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

要件

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