通过

WdfWorkItemGetParentObject 函数 （wdfworkitem.h）

  • 项目

[适用于 KMDF 和 UMDF]

WdfWorkItemGetParentObject 方法返回与指定工作项关联的框架对象。

语法

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

参数

[in] WorkItem

从上一次调用 WdfWorkItemCreate获取的框架工作项对象的句柄。

返回值

WdfWorkItemGetParentObject 在驱动程序之前调用 WdfWorkItemCreate时，将驱动程序指定为 ParentObjectWDF_OBJECT_ATTRIBUTES 成员的框架对象返回一个句柄。

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

言论

有关工作项的详细信息，请参阅 使用框架工作项。

例子

以下代码示例是来自 1394 示例驱动程序的 EvtWorkItem 回调函数。 该示例获取工作项的父设备对象，调用驱动程序定义的例程来处理工作项，然后删除工作项对象。

VOID
t1394_BusResetRoutineWorkItem(
    IN WDFWORKITEM  WorkItem
)
{
    WDFDEVICE  Device = WdfWorkItemGetParentObject(WorkItem);

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfworkitem.h （包括 Wdf.h）
库 Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF）
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另请参阅

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate