通过

WdfDeviceWdmGetAttachedDevice 函数 （wdfdevice.h）

  • 项目

[仅适用于 KMDF]

WdfDeviceWdmGetAttachedDevice 方法返回 设备堆栈中下一个较低的 WDM 设备对象。

语法

PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
  [in] WDFDEVICE Device
);

参数

[in] Device

框架设备对象的句柄。

返回值

WdfDeviceWdmGetAttachedDevice 返回指向 WDM DEVICE_OBJECT 结构的指针。 如果指定的对象句柄表示物理设备对象（PDO），该方法将返回 NULL。

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

注解

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

例子

下面的代码示例创建一条跟踪消息，其中包含指向表示设备的 PDO、FDO 和下一低设备的 WDM 设备对象的指针。

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            DBG_PNP,
            "PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device),
            WdfDeviceWdmGetAttachedDevice(device)
            );

要求

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

另请参阅

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice