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