[适用于 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_CONFIG 的 automaticSerialization 成员设置为 TRUE 无效。
如果 自动序列化TRUE,则父对象的执行级别必须 WdfExecutionLevelPassive。
有关 自动序列化 和同步驱动程序回调函数的详细信息,请参阅 同步技术 Framework-Based 驱动程序。
要求
| 要求 | 价值 |
|---|---|
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfworkitem.h (包括 Wdf.h) |