WDF_WORKITEM_CONFIG 结构 (wdfworkitem.h)

[适用于 KMDF 和 UMDF]

WDF_WORKITEM_CONFIG 结构包含与工作项关联的信息。

语法

typedef struct _WDF_WORKITEM_CONFIG {
  ULONG            Size;
  PFN_WDF_WORKITEM EvtWorkItemFunc;
  BOOLEAN          AutomaticSerialization;
} WDF_WORKITEM_CONFIG, *PWDF_WORKITEM_CONFIG;

成员

Size

WDF_WORKITEM_CONFIG 结构的大小(以字节为单位)。

EvtWorkItemFunc

EvtWorkItem 事件回调函数的地址。

AutomaticSerialization

一个布尔值,如果 为 TRUE,则指示框架会将 EvtWorkItem 回调函数的执行与来自工作项对象的父对象下的其他对象的回调函数同步。 有关更多信息,请参见下面的“备注”部分。 如果 为 FALSE,则框架不会同步 EvtWorkItem 回调函数的执行。

注解

驱动程序必须通过调用 WDF_WORKITEM_CONFIG_INIT 来初始化 WDF_WORKITEM_CONFIG 结构。 然后,驱动程序可以将结构作为输入参数传递给 WdfWorkItemCreate 方法。

如果将父对象的同步范围设置为 WdfSynchronizationScopeNone,则WDF_WORKITEM_CONFIGAutomaticSerialization 成员设置为 TRUE 不起作用。

如果 AutomaticSerializationTRUE,则父对象的执行级别必须为 WdfExecutionLevelPassive

有关 AutomaticSerialization 和同步驱动程序回调函数的详细信息,请参阅 Framework-Based 驱动程序的同步技术

要求

要求
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfworkitem.h (包括 Wdf.h)

另请参阅

EvtWorkItem

WDF_WORKITEM_CONFIG_INIT

WdfWorkItemCreate