Condividi tramite


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

Dimensione, in byte, della struttura FLT_RELATED_CONTEXTS_EX a cui punta 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 del minifiltro.

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

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

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

I chiamanti di FltReleaseContextsEx devono essere eseguiti in IRQL <= DISPATCH_LEVEL se tutti i contesti sono stati allocati da un pool non di paging. Se uno dei contesti è stato allocato dal pool di paging, 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, viene pianificato un elemento di lavoro per liberare il contesto.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows 8.
piattaforma di destinazione Universale
intestazione fltkernel.h (include Fltkernel.h)
libreria FltMgr.lib
dll Fltmgr.sys
IRQL Vedere la sezione Osservazioni.

Vedere anche

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext