Funzione FltGetStreamContext (fltkernel.h)

Articolo
04/27/2023

La routine FltGetStreamContext recupera un contesto impostato per un flusso di file da una determinata istanza del driver minifilter.

Sintassi

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

Parametri

[in] Instance

Puntatore dell'istanza opaca per l'istanza del driver minifilter il cui contesto deve essere recuperato.

[in] FileObject

Puntatore a un oggetto file per il flusso.

[out] Context

Puntatore a una variabile allocata dal chiamante che riceve l'indirizzo del contesto. Questo parametro è obbligatorio e non può essere impostato su NULL.

Valore restituito

FltGetStreamContext restituisce STATUS_SUCCESS quando restituisce correttamente il contesto richiesto. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_NOT_FOUND	In questo momento non è stato trovato alcun contesto corrispondente in questo file, quindi FltMgr imposta Context su NULL_CONTEXT. Si tratta di un codice di errore.
STATUS_NOT_SUPPORTED	Il file system non supporta i contesti per flusso per questo flusso di file. Si tratta di un codice di errore.

Commenti

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

FltGetStreamContext recupera un contesto impostato per un flusso di file da una determinata istanza del driver minifilter.

FltGetStreamContext incrementa il conteggio dei riferimenti nel contesto a cui punta il parametro Context . Quando questo puntatore di contesto non è più necessario, il chiamante deve decrementare il conteggio dei riferimenti chiamando FltReleaseContext. Ogni chiamata riuscita a FltGetStreamContext deve quindi corrispondere a una chiamata successiva a FltReleaseContext.

Per impostare un contesto per un flusso di file, chiamare FltSetStreamContext.

Per allocare un nuovo contesto, chiamare FltAllocateContext.

Per eliminare un contesto di flusso, chiamare FltDeleteStreamContext o FltDeleteContext.