WdfFdoInitWdmGetPhysicalDevice 函数 (wdffdo.h)

  • 项目

[仅适用于 KMDF]

WdfFdoInitWdmGetPhysicalDevice 方法 (PDO) 检索设备的 WDM 物理设备对象。

语法

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

参数

[in] DeviceInit

指向驱动程序从其 EvtDriverDeviceAdd 回调函数获取的 WDFDEVICE_INIT 结构的指针。

返回值

如果操作成功，该方法将返回指向 DEVICE_OBJECT 结构的指针。 否则，该方法返回 NULL。

注解

驱动程序必须先调用 WdfFdoInitWdmGetPhysicalDevice ，然后才能调用 WdfDeviceCreate。 有关调用 WdfDeviceCreate 的详细信息，请参阅 创建框架设备对象。

有关 WdfFdoInitWdmGetPhysicalDevice 方法的详细信息，请参阅 在函数驱动程序中创建设备对象。

示例

下面的代码示例获取指向表示设备的 WDM PDO DEVICE_OBJECT 结构的指针。

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdffdo.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf)