WDF_DPC_CONFIG structure (wdfdpc.h)

Article
08/08/2023

[S’applique à KMDF uniquement]

La structure WDF_DPC_CONFIG contient des informations de configuration pour un objet DPC.

Syntaxe

typedef struct _WDF_DPC_CONFIG {
  ULONG       Size;
  PFN_WDF_DPC EvtDpcFunc;
  BOOLEAN     AutomaticSerialization;
} WDF_DPC_CONFIG, *PWDF_DPC_CONFIG;

Membres

Size

Taille, en octets, de cette structure.

EvtDpcFunc

Pointeur vers la fonction de rappel EvtDpcFunc du pilote.

AutomaticSerialization

Valeur booléenne qui, si elle est TRUE, indique que l’infrastructure synchronisera l’exécution de la fonction de rappel EvtDpcFunc de l’objet DPC avec les fonctions de rappel d’autres objets qui se trouvent sous le parent de l’objet DPC. Pour plus d'informations, consultez la section Notes qui suit.

Remarques

La structure WDF_DPC_CONFIG est utilisée comme entrée dans WdfDpcCreate.

Pour initialiser une structure WDF_DPC_CONFIG , votre pilote doit d’abord appeler WDF_DPC_CONFIG_INIT , puis renseigner les membres de la structure que WDF_DPC_CONFIG_INIT n’initialise pas.

L’attribution de la valeur TRUE à AutomaticSerialization n’a aucun effet si l’étendue de synchronisation de l’objet d’appareil parent est définie sur WdfSynchronizationScopeNone.

L’attribution de la valeur TRUE à AutomaticSerialization entraîne l’échec de WdfDpcCreate si le niveau d’exécution de l’objet d’appareil parent est défini sur WdfExecutionLevelPassive.

Pour plus d’informations sur l’automaticSerialization et la synchronisation des fonctions de rappel de pilote, consultez Synchronization Techniques for Framework-Based Drivers.

Pour plus d’informations sur la gestion des interruptions dans les pilotes basés sur l’infrastructure, consultez Gestion des interruptions matérielles.

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1.0
En-tête	wdfdpc.h (inclure Wdf.h)

Voir aussi