structure WDF_WORKITEM_CONFIG (wdfworkitem.h)
[S’applique à KMDF et UMDF]
La structure WDF_WORKITEM_CONFIG contient des informations associées à un élément de travail.
Syntaxe
typedef struct _WDF_WORKITEM_CONFIG {
ULONG Size;
PFN_WDF_WORKITEM EvtWorkItemFunc;
BOOLEAN AutomaticSerialization;
} WDF_WORKITEM_CONFIG, *PWDF_WORKITEM_CONFIG;
Membres
Size
Taille, en octets, de cette structure WDF_WORKITEM_CONFIG .
EvtWorkItemFunc
Adresse d’une fonction de rappel d’événement EvtWorkItem .
AutomaticSerialization
Valeur booléenne qui, si TRUE, indique que l’infrastructure synchronisera l’exécution de la fonction de rappel EvtWorkItem avec les fonctions de rappel d’autres objets qui se trouvent sous l’objet parent de l’objet élément de travail. Pour plus d'informations, consultez la section Notes qui suit. Si la valeur est FALSE, l’infrastructure ne synchronise pas l’exécution de la fonction de rappel EvtWorkItem .
Remarques
Votre pilote doit initialiser la structure WDF_WORKITEM_CONFIG en appelant WDF_WORKITEM_CONFIG_INIT. Votre pilote peut ensuite passer la structure à la méthode WdfWorkItemCreate en tant que paramètre d’entrée.
La définition du membre AutomaticSerialization de WDF_WORKITEM_CONFIG sur TRUE n’a aucun effet si l’étendue de synchronisation de l’objet parent est définie sur WdfSynchronizationScopeNone.
Si AutomaticSerialization a la valeur TRUE, le niveau d’exécution de l’objet parent doit être WdfExecutionLevelPassive.
Pour plus d’informations sur l’automaticSérialisation et la synchronisation des fonctions de rappel de pilote, consultez Techniques de synchronisation pour les pilotes Framework-Based.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfworkitem.h (include Wdf.h) |