Freigeben über

WDF_EXECUTION_LEVEL-Aufzählung (wdfobject.h)

  • Artikel

[Gilt für KMDF und UMDF]

Der WDF_EXECUTION_LEVEL Enumerationstyp gibt die maximale IRQL an, bei der das Framework die Ereignisrückruffunktionen aufruft, die ein Treiber für ein Frameworkobjekt bereitgestellt hat.

Syntax

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

Konstanten

 
WdfExecutionLevelInvalid
Wert: 0x00
Reserviert für die Systemverwendung.
WdfExecutionLevelInheritFromParent
Das Framework verwendet den maximalen IRQL-Wert des übergeordneten Objekts, es sei denn, das Objekt ist eine, die IRQL = DISPATCH_LEVEL erfordert (z. B. ein DPC-Objekt). Dieser Wert ist der Standardwert, wenn ein Treiber keinen wert vom Typ WDF_EXECUTION_LEVEL angibt.
WdfExecutionLevelPassive
Das Framework ruft immer die Rückruffunktionen des Objekts bei IRQL = PASSIVE_LEVEL auf.
WdfExecutionLevelDispatch
Das Framework ruft die Rückruffunktionen des Objekts bei IRQL <= DISPATCH_LEVEL auf. In UMDF nicht verfügbar.

Bemerkungen

Treiber verwenden den WDF_EXECUTION_LEVEL Enumerationstyp, um das ExecutionLevel Element der WDF_OBJECT_ATTRIBUTES Struktur eines Objekts anzugeben.

Sie können einen ExecutionLevel Wert für die folgenden Objekte angeben:

  • Frameworktreiberobjekte
  • Framework-Geräteobjekte
  • Framework-Dateiobjekte
  • Allgemeine Framework-Objekte
  • Framework-Warteschlangenobjekte (Framework-Versionen 1.9 und höher)
  • Framework-Timerobjekte (Framework-Versionen 1.9 und höher)
KMDF-Standardmäßig legt das Framework den ExecutionLevel- Wert von Frameworktreiberobjekten auf WdfExecutionLevelDispatch fest.

UMDF-Standardmäßig legt das Framework den ExecutionLevel Wert von Frameworktreiberobjekten auf WdfExecutionLevelPassive fest.

Der Standardwert ExecutionLevel für alle anderen Objekte ist WdfExecutionLevelInheritFromParent.

Weitere Informationen zu Ausführungsebenen für Ereignisrückruffunktionen finden Sie unter Synchronisierungstechniken für Framework-Based Drivers.

Anforderungen

Anforderung Wert
Minimale KMDF-Version 1.0
Mindest-UMDF-Version 2.0
Kopfzeile wdfobject.h (einschließen Wdf.h)

Siehe auch

WDF_OBJECT_ATTRIBUTES