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) |