enumerazione WDF_EXECUTION_LEVEL (wdfobject.h)

Articolo
02/27/2024

[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

Condividi tramite