WUDF_WORKITEM_FUNCTION回调函数 (wudfworkitem.h)

[警告: UMDF 2 是最新版本的 UMDF,并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]

驱动程序的 OnWorkItem 事件回调函数执行与指定工作项关联的工作。

语法

WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;

void WudfWorkitemFunction(
  [in] IWDFWorkItem *pWorkItem
)
{...}

参数

[in] pWorkItem

指向 IWDFWorkItem 接口的 指针。

返回值

备注

若要注册 OnWorkItem 回调函数,驱动程序必须在调用 IWDFDevice3::CreateWorkItem 之前将回调函数的地址置于WUDF_WORKITEM_CONFIG结构中。

通常,驱动程序的 OnWorkItem 回调函数执行由驱动程序存储在工作项对象的上下文内存中的信息指定的任务。

驱动程序不得从 OnWorkItem 回调函数调用 IWDFObject::D eleteWdfObject

有关详细信息,请参阅 使用工作项

示例

函数类型在 Wudfworkitem.h 中声明,如下所示。

typedef
VOID
WUDF_WORKITEM_FUNCTION(
    _In_
    IWDFWorkItem* pWorkItem
    );

typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;

若要定义名为 MyWorkItemOnWorkItem 回调函数,必须先提供 SDV 和其他验证工具所需的函数声明,如下所示:

WUDF_WORKITEM_FUNCTION  MyWorkItem;

然后,按如下所示实现回调函数:

VOID
  MyWorkItem (
   _In_
    IWDFWorkItem* pWorkItem
    )
  {…}

要求

要求
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.11
标头 wudfworkitem.h

另请参阅

IWDFDevice3::CreateWorkItem

IWDFObject::D eleteWdfObject

WUDF_WORKITEM_CONFIG