structure WDF_WORKITEM_CONFIG (wdfworkitem.h)

  • Article

[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)

Voir aussi

EvtWorkItem

WDF_WORKITEM_CONFIG_INIT

WdfWorkItemCreate