énumération WDF_EXECUTION_LEVEL (wdfobject.h)

  • Article

[S’applique à KMDF et UMDF]

Le type d’énumération WDF_EXECUTION_LEVEL spécifie l’IRQL maximal auquel l’infrastructure appellera les fonctions de rappel d’événement qu’un pilote a fournies pour un objet framework.

Syntax

typedef enum _WDF_EXECUTION_LEVEL {
  WdfExecutionLevelInvalid = 0x00,
  WdfExecutionLevelInheritFromParent,
  WdfExecutionLevelPassive,
  WdfExecutionLevelDispatch
} WDF_EXECUTION_LEVEL;

Constantes

 
WdfExecutionLevelInvalid
Valeur : 0x00
Réservé pour le système.
WdfExecutionLevelInheritFromParent
L’infrastructure utilise la valeur IRQL maximale du parent de l’objet, sauf si l’objet nécessite IRQL = DISPATCH_LEVEL (par exemple, un objet DPC). Cette valeur est la valeur par défaut si un pilote ne spécifie pas de valeur de type WDF_EXECUTION_LEVEL.
WdfExecutionLevelPassive
Le framework appelle toujours les fonctions de rappel de l’objet à l’adresse IRQL = PASSIVE_LEVEL.
WdfExecutionLevelDispatch
L’infrastructure appelle les fonctions de rappel de l’objet dans IRQL <= DISPATCH_LEVEL. Non disponible dans UMDF.

Remarques

Les pilotes utilisent le type d’énumération WDF_EXECUTION_LEVEL pour spécifier le membre ExecutionLevel de la structure WDF_OBJECT_ATTRIBUTES d’un objet.

Vous pouvez spécifier une valeur ExecutionLevel pour les objets suivants :

  • Objets du pilote d’infrastructure
  • Objets d’appareil framework
  • Objets de fichier d’infrastructure
  • Objets généraux du framework
  • Objets de file d’attente du framework (Framework versions 1.9 et ultérieures)
  • Objets du minuteur d’infrastructure (Framework versions 1.9 et ultérieures)
KMDF Par défaut, l’infrastructure définit la valeur ExecutionLevel des objets de pilote d’infrastructure sur WdfExecutionLevelDispatch.

UMDF Par défaut, l’infrastructure définit la valeur ExecutionLevel des objets de pilote d’infrastructure sur WdfExecutionLevelPassive.

La valeur executionLevel par défaut pour tous les autres objets est WdfExecutionLevelInheritFromParent.

Pour plus d’informations sur les niveaux d’exécution des fonctions de rappel d’événements, 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 wdfobject.h (inclure Wdf.h)

Voir aussi

WDF_OBJECT_ATTRIBUTES