Funzione FltGetVolumeContext (fltkernel.h)

Articolo
04/27/2023

La routine FltGetVolumeContext recupera un contesto impostato per un volume da un determinato driver minifilter.

Sintassi

NTSTATUS FLTAPI FltGetVolumeContext(
  [in]  PFLT_FILTER  Filter,
  [in]  PFLT_VOLUME  Volume,
  [out] PFLT_CONTEXT *Context
);

Parametri

[in] Filter

Puntatore di filtro opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] Volume

Puntatore opaco per il volume il cui contesto viene recuperato. Questo parametro è obbligatorio e non può essere NULL.

[out] Context

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

Valore restituito

FltGetVolumeContext restituisce STATUS_SUCCESS quando restituisce correttamente il contesto richiesto. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio:

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.

Commenti

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

FltGetVolumeContext 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 FltGetVolumeContext deve quindi corrispondere a una chiamata successiva a FltReleaseContext.

Per impostare un contesto per un volume, chiamare FltSetVolumeContext.

Per allocare un nuovo contesto, chiamare FltAllocateContext.

Per eliminare un contesto di volume, chiamare FltDeleteVolumeContext o FltDeleteContext.