Funzione FltDeleteInstanceContext (fltkernel.h)

Articolo
08/07/2023

FltDeleteInstanceContext rimuove un contesto da una determinata istanza e contrassegna il contesto per l'eliminazione.

Sintassi

NTSTATUS FLTAPI FltDeleteInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *OldContext
);

Parametri

[in] Instance

Puntatore dell'istanza opaca per l'istanza.

[out] OldContext

Puntatore a una variabile allocata dal chiamante che riceve l'indirizzo del contesto eliminato. Questo parametro è facoltativo e può essere NULL. Se OldContext non è NULL e non punta a NULL_CONTEXT, il chiamante è responsabile della chiamata a FltReleaseContext per rilasciare questo contesto quando non è più necessario.

Valore restituito

FltDeleteInstanceContext restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_FLT_DELETING_OBJECT	L'istanza specificata viene distrutta. Si tratta di un codice di errore.
STATUS_NOT_FOUND	Non è stato trovato alcun contesto corrispondente. Si tratta di un codice di errore.

Commenti

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

Poiché i contesti vengono conteggiati dai riferimenti, non è in genere necessario per un driver minifilter chiamare una routine come FltDeleteInstanceContext per eliminare in modo esplicito un contesto.

Un driver minifilter chiama FltDeleteInstanceContext per rimuovere un contesto da un'istanza e contrassegnare il contesto per l'eliminazione. Il contesto viene in genere liberato immediatamente, a meno che non vi sia un riferimento in sospeso ( ad esempio, perché il contesto è ancora in uso da un altro thread).

Per allocare un nuovo contesto, chiamare FltAllocateContext.

Per ottenere un contesto di istanza, chiamare FltGetInstanceContext.

Per impostare un contesto di istanza, chiamare FltSetInstanceContext.