Share via

enumerazione WDF_EXECUTION_LEVEL (wdfobject.h)

  • Articolo

[Si applica a KMDF e UMDF]

Il tipo di enumerazione WDF_EXECUTION_LEVEL specifica il numero massimo di IRQL in cui il framework chiamerà le funzioni di callback dell'evento 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'utilizzo nel sistema.
WdfExecutionLevelInheritFromParent
Il framework usa il valore IRQL massimo dell'elemento padre dell'oggetto, a meno che l'oggetto non sia quello che richiede IRQL = DISPATCH_LEVEL (ad esempio un oggetto DPC). Questo valore è il valore predefinito se un driver non specifica un valore tipizzato di 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.

Commenti

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 generico oggetti
  • Oggetti code framework (versioni di Framework 1.9 e versioni successive)
  • Oggetti timer framework (versione framework 1.9 e versioni 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 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 Tecniche di sincronizzazione per i driver di Framework-Based.

Requisiti

Requisito Valore
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfobject.h (includere Wdf.h)

Vedi anche

WDF_OBJECT_ATTRIBUTES