estructura WDF_WORKITEM_CONFIG (wdfworkitem.h)
[Se aplica a KMDF y UMDF]
La estructura WDF_WORKITEM_CONFIG contiene información asociada a un elemento de trabajo.
Sintaxis
typedef struct _WDF_WORKITEM_CONFIG {
ULONG Size;
PFN_WDF_WORKITEM EvtWorkItemFunc;
BOOLEAN AutomaticSerialization;
} WDF_WORKITEM_CONFIG, *PWDF_WORKITEM_CONFIG;
Miembros
Size
Tamaño, en bytes, de esta estructura WDF_WORKITEM_CONFIG .
EvtWorkItemFunc
Dirección de una función de devolución de llamada de evento EvtWorkItem .
AutomaticSerialization
Valor booleano que, si es TRUE, indica que el marco sincronizará la ejecución de la función de devolución de llamada EvtWorkItem con funciones de devolución de llamada de otros objetos que están debajo del objeto primario del objeto de elemento de trabajo. Para obtener más información, vea la sección Comentarios que se muestra más adelante. Si es FALSE, el marco no sincroniza la ejecución de la función de devolución de llamada EvtWorkItem .
Comentarios
El controlador debe inicializar la estructura de WDF_WORKITEM_CONFIG llamando a WDF_WORKITEM_CONFIG_INIT. Después, el controlador puede pasar la estructura al método WdfWorkItemCreate como parámetro de entrada.
Establecer el miembro AutomaticSerialization de WDF_WORKITEM_CONFIG en TRUE no tiene ningún efecto si el ámbito de sincronización del objeto primario está establecido en WdfSynchronizationScopeNone.
Si AutomaticSerialization es TRUE, el nivel de ejecución del objeto primario debe ser WdfExecutionLevelPassive.
Para obtener más información sobre la automaticserialización y la sincronización de las funciones de devolución de llamada del controlador, consulte Técnicas de sincronización para controladores de Framework-Based.
Requisitos
| Requisito | Value |
|---|---|
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfworkitem.h (include Wdf.h) |