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. |