Condividi tramite


Funzione FltDeleteStreamHandleContext (fltkernel.h)

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.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione fltkernel.h (include Fltkernel.h)
Libreria FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Vedi anche

FltAllocateContext

FltDeleteContext

FltGetStreamHandleContext

FltReleaseContext

FltSetStreamHandleContext