WDF_EXECUTION_LEVEL-Enumeration (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
Ist für das System reserviert.
WdfExecutionLevelInheritFromParent
Das Framework verwendet den maximalen IRQL-Wert des übergeordneten Objekts, es sei denn, das Objekt ist eines, das IRQL = DISPATCH_LEVEL erfordert (z. B. ein DPC-Objekt). Dieser Wert ist der Standardwert, wenn ein Treiber keinen WDF_EXECUTION_LEVEL typisierten Wert angibt.
WdfExecutionLevelPassive
Das Framework ruft die Rückruffunktionen des Objekts immer unter IRQL = PASSIVE_LEVEL auf.
WdfExecutionLevelDispatch
Das Framework ruft die Rückruffunktionen des Objekts unter IRQL <= DISPATCH_LEVEL auf. In UMDF nicht verfügbar.

Hinweise

Treiber verwenden den WDF_EXECUTION_LEVEL-Enumerationstyp, um den ExecutionLevel-Member der WDF_OBJECT_ATTRIBUTES-Struktur eines Objekts anzugeben.

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

  • Frameworktreiberobjekte
  • Frameworkgeräteobjekte
  • Frameworkdateiobjekte
  • 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 Standardmäßige ExecutionLevel-Wert für alle anderen Objekte ist WdfExecutionLevelInheritFromParent.

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

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfobject.h (einschließen von Wdf.h)

Weitere Informationen

WDF_OBJECT_ATTRIBUTES