énumération WDF_EXECUTION_LEVEL (wdfobject.h)

Article
02/27/2024

[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

Partager via