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的详细信息,请参阅 创建框架设备对象

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

例子

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

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
标头 wdffdo.h (包括 Wdf.h)
图书馆 Wdf01000.sys(请参阅框架库版本控制。
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DeviceInitAPI(kmdf)DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)