Partager via

énumération WDF_EXECUTION_LEVEL (wdfobject.h)

[S’applique à KMDF et UMDF]

Le type d’énumération WDF_EXECUTION_LEVEL spécifie le paramètre IRQL maximal auquel l’infrastructure appelle les fonctions de rappel d’événements fournies par un pilote pour un objet framework.

Syntaxe

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

Constantes

 
WdfExecutionLevelInvalid
Valeur : 0x00
Réservé à l’utilisation du système.
WdfExecutionLevelInheritFromParent
L’infrastructure utilise la valeur IRQL maximale du parent de l’objet, sauf si l’objet est un objet qui 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 WDF_EXECUTION_LEVEL typée.
WdfExecutionLevelPassive
L’infrastructure appelle toujours les fonctions de rappel de l’objet à IRQL = PASSIVE_LEVEL.
WdfExecutionLevelDispatch
L’infrastructure appelle les fonctions de rappel de l’objet au <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 de pilote framework
  • Objets d’appareil framework
  • Objets de fichier framework
  • Objets généraux du framework
  • Objets de file d’attente framework (framework versions 1.9 et ultérieures)
  • Objets du minuteur framework (Framework versions 1.9 et ultérieures)
KMDF par défaut, l’infrastructure définit la valeur ExecutionLevel des objets du 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 par défaut ExecutionLevel 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 Framework-Based Pilotes.

Spécifications

Besoin Valeur
version minimale de KMDF 1.0
version minimale de UMDF 2.0
En-tête wdfobject.h (include Wdf.h)

Voir aussi

WDF_OBJECT_ATTRIBUTES

  • Last updated on