enumerazione WDF_EXECUTION_LEVEL (wdfobject.h)

Articolo
03/22/2025

[Si applica a KMDF e UMDF]

Il tipo di enumerazione WDF_EXECUTION_LEVEL specifica il valore massimo di IRQL in cui il framework chiamerà le funzioni di callback degli eventi fornite da un driver per un oggetto framework.

Sintassi

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

Costanti


`WdfExecutionLevelInvalid` Valore: 0x00 Riservato per l'uso del sistema.
`WdfExecutionLevelInheritFromParent` Il framework usa il valore IRQL massimo dell'elemento padre dell'oggetto, a meno che l'oggetto non sia uno che richiede IRQL = DISPATCH_LEVEL (ad esempio un oggetto DPC). Questo valore è l'impostazione predefinita se un driver non specifica un valore tipizzato WDF_EXECUTION_LEVEL.
`WdfExecutionLevelPassive` Il framework chiama sempre le funzioni di callback dell'oggetto in IRQL = PASSIVE_LEVEL.
`WdfExecutionLevelDispatch` Il framework chiama le funzioni di callback dell'oggetto in IRQL <= DISPATCH_LEVEL. Non disponibile in UMDF.

Osservazioni:

I driver usano il tipo di enumerazione WDF_EXECUTION_LEVEL per specificare il membro ExecutionLevel della struttura WDF_OBJECT_ATTRIBUTES di un oggetto.

È possibile specificare un valore ExecutionLevel per gli oggetti seguenti:

Oggetti driver framework
Oggetti dispositivo framework
Oggetti file framework
Framework oggetti generali
Oggetti coda framework (framework versioni 1.9 e successive)
Oggetti timer framework (Framework versioni 1.9 e successive)

KMDF Per impostazione predefinita, il framework imposta il valore ExecutionLevel degli oggetti driver del framework su WdfExecutionLevelDispatch.

UMDF Per impostazione predefinita, il framework imposta il valore di ExecutionLevel degli oggetti driver del framework su WdfExecutionLevelPassive.

Il valore predefinito ExecutionLevel per tutti gli altri oggetti è WdfExecutionLevelInheritFromParent.

Per altre informazioni sui livelli di esecuzione per le funzioni di callback degli eventi, vedere Synchronization Techniques for Framework-Based Drivers.

Requisiti

Requisito	Valore
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfobject.h (include Wdf.h)

Vedere anche

WDF_OBJECT_ATTRIBUTES

Condividi tramite