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