Funzione FltGetFileContext (fltkernel.h)
La routine FltGetFileContext recupera un contesto impostato per un file da una determinata istanza del driver minifilter.
Sintassi
NTSTATUS FLTAPI FltGetFileContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parametri
[in] Instance
Puntatore dell'istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
[in] FileObject
Puntatore a oggetti file per il file. Questo parametro è obbligatorio e non può essere NULL.
[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
FltGetFileContext restituisce STATUS_SUCCESS quando restituisce correttamente il contesto del file 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 | I contesti di file non sono supportati per questo file. Si tratta di un codice di errore. |
Commenti
Per altre informazioni sui contesti, vedere Informazioni sui contesti minifilter.
Un driver minifilter chiama FltGetFileContext per recuperare il contesto di file impostato per un determinato file.
FltGetFileContext 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. Di conseguenza, ogni chiamata riuscita a FltGetFileContext deve corrispondere a una chiamata successiva a FltReleaseContext.
Per impostare un contesto di file, chiamare FltSetFileContext.
Per allocare un nuovo contesto, chiamare FltAllocateContext.
Per eliminare un contesto di file, chiamare FltDeleteFileContext o FltDeleteContext.
Per determinare se i contesti di file sono supportati per un determinato file, chiamare FltSupportsFileContexts o FltSupportsFileContextsEx.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Universale |
| Intestazione | fltkernel.h (include Fltkernel.h) |
| Libreria | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |