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