Funzione FltGetSectionContext (fltkernel.h)

  • Articolo

La routine FltGetSectionContext recupera un contesto di sezione creato per un flusso di file da un'istanza del driver minifilter specificata.

Sintassi

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

Parametri

[in] Instance

Puntatore di istanza opaco 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

FltGetSectionContext restituisce STATUS_SUCCESS quando restituisce correttamente il contesto della sezione richiesta. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito Descrizione
STATUS_NOT_FOUND Non è stato trovato alcun contesto corrispondente in questo file, quindi FltMgr imposta Contesto su NULL_CONTEXT. Si tratta di un codice di errore.
STATUS_NOT_SUPPORTED Il volume collegato a questa istanza non supporta i contesti di sezione. Si tratta di un codice di errore.

Commenti

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

FltGetSectionContext recupera un contesto di sezione creato per un flusso di file da un'istanza del driver minifilter specificata. Viene creato un contesto di sezione chiamando FltCreateSectionForDataScan.

FltGetSectionContext 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. Pertanto ogni chiamata riuscita a FltGetSectionContext deve essere corrispondente a una chiamata successiva a FltReleaseContext.

Per allocare un nuovo contesto, chiamare FltAllocateContext.

I minifilter non devono eliminare in modo esplicito un contesto di sezione passato a FltCreateSectionForDataScan. Un contesto di sezione viene deallocato e rimosso da un flusso chiamando FltCloseSectionForDataScan in questo caso.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Piattaforma di destinazione Universale
Intestazione fltkernel.h (includere Fltkernel.h)
Libreria FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Vedi anche

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FltReleaseContext