WdfDeviceWdmGetPhysicalDevice 函数 (wdfdevice.h)

[仅适用于 KMDF]

WdfDeviceWdmGetPhysicalDevice 方法从设备堆栈中检索物理设备的 WDM PDO。

语法

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

参数

[in] Device

框架设备对象的句柄。

返回值

WdfDeviceWdmGetPhysicalDevice 返回指向 DEVICE_OBJECT 结构的指针。

如果驱动程序提供无效的对象句柄,则会发生 bug 检查。

如果调用方提供控制设备对象,则 WdfDeviceWdmGetPhysicalDevice 返回 NULL

注解

WdfDeviceWdmGetPhysicalDevice 方法返回的指针在删除框架设备对象之前有效。 如果驱动程序为框架设备对象提供 EvtCleanupCallback 函数,指针将有效,直到回调函数返回。

例子

有关使用 WdfDeviceWdmGetPhysicalDevice的代码示例,请参阅 WdfDeviceWdmGetAttachedDevice

要求

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