WdfFdoInitWdmGetPhysicalDevice 函式 (wdffdo.h)

  • 發行項

[僅適用於 KMDF]

WdfFdoInitWdmGetPhysicalDevice 方法會擷取裝置的 WDM 實體裝置物件， (PDO) 。

語法

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

參數

[in] DeviceInit

驅動程式從其 EvtDriverDeviceAdd 回呼函式取得之WDFDEVICE_INIT結構的指標。

傳回值

如果作業成功，方法會傳回 DEVICE_OBJECT 結構的指標。 否則，方法會傳回 NULL。

備註

驅動程式必須先呼叫 WdfFdoInitWdmGetPhysicalDevice ，才能呼叫 WdfDeviceCreate。 如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立 Framework 裝置物件。

如需 WdfFdoInitWdmGetPhysicalDevice 方法的詳細資訊，請參閱 在函式驅動程式中建立裝置物件。

範例

下列程式代碼範例會取得代表裝置 WDM PDO 之DEVICE_OBJECT結構的指標。

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdffdo.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf ) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)