Funzione FltReleaseContextsEx (fltkernel.h)

FltReleaseContextsEx rilascia ogni contesto in una determinata struttura FLT_RELATED_CONTEXTS_EX .

Sintassi

VOID FLTAPI FltReleaseContextsEx(
  [in] SIZE_T                   ContextsSize,
  [in] PFLT_RELATED_CONTEXTS_EX Contexts
);

Parametri

[in] ContextsSize

Dimensioni, in byte, della struttura FLT_RELATED_CONTEXTS_EX puntata da Contesti. Impostare su sizeof(FLT_RELATED_CONTEXTS_EX).

[in] Contexts

Puntatore alla struttura FLT_RELATED_CONTEXTS_EX .

Valore restituito

nessuno

Osservazioni

Per altre informazioni sui contesti, vedere Informazioni sui contesti minifilter.

FltReleaseContextsEx decrementa il conteggio dei riferimenti su tutti i contesti della struttura FLT_RELATED_CONTEXTS_EX e imposta tutti i membri della struttura su NULL_CONTEXT .

Per ottenere la struttura di FLT_RELATED_CONTEXTS_EX per un determinato driver minifilter per una determinata richiesta di I/O, chiamare FltGetContextsEx.

Per altre informazioni sul conteggio dei riferimenti al contesto, vedere Riferimenti ai contesti.

I chiamanti di FltReleaseContextsEx devono essere in esecuzione in IRQL <= DISPATCH_LEVEL se tutti i contesti sono stati allocati da un pool non con pagine. Se eventuali contesti sono stati allocati dal pool a pagina, i chiamanti devono essere in esecuzione in IRQL <= APC_LEVEL.

Quando il numero di riferimenti di ogni contesto raggiunge zero, il contesto viene liberato immediatamente se il chiamante è in esecuzione in IRQL <= APC_LEVEL. Se il chiamante è in esecuzione in IRQL DISPATCH_LEVEL, un elemento di lavoro viene pianificato per liberare il contesto.

Requisiti

Vedi anche

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext