Funzione FltDeleteStreamHandleContext (fltkernel.h)

Articolo
02/29/2024

FltDeleteStreamHandleContext rimuove un contesto impostato da una determinata istanza del driver minifilter per un handle di flusso specificato e contrassegna il contesto per l'eliminazione.

Sintassi

NTSTATUS FLTAPI FltDeleteStreamHandleContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

Parametri

[in] Instance

Puntatore di istanza opaca per l'istanza del driver minifilter il cui contesto deve essere rimosso dall'elenco di contesti collegati all'handle di flusso.

[in] FileObject

Puntatore a un oggetto file per il flusso di file.

[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

FltDeleteStreamHandleContext 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.
STATUS_NOT_SUPPORTED	Il file system non supporta i contesti per flusso per questo handle di flusso di file. 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 FltDeleteStreamHandleContext per eliminare in modo esplicito un contesto.

Un driver minifilter chiama FltDeleteStreamHandleContext per rimuovere un contesto da un handle di flusso 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 flusso, chiamare FltGetStreamHandleContext.

Per impostare un contesto di flusso, chiamare FltSetStreamHandleContext.