Funzione FltGetStreamHandleContext (fltkernel.h)
La routine FltGetStreamHandleContext recupera un contesto impostato per un handle di flusso da un'istanza del driver minifilter specificata.
Sintassi
NTSTATUS FLTAPI FltGetStreamHandleContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parametri
[in] Instance
Puntatore istanza opaca per l'istanza del driver minifilter il cui contesto deve essere recuperato.
[in] FileObject
Puntatore a un oggetto file per l'handle di flusso.
[out] Context
Puntatore a una variabile allocata del chiamante che riceve l'indirizzo del contesto. Questo parametro non può essere impostato su NULL.
Valore restituito
FltGetStreamHandleContext 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 | 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 file system non supporta 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.
FltGetStreamHandleContext recupera un contesto impostato per un handle di flusso da un determinato driver minifilter.
FltGetStreamHandleContext 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 FltGetStreamHandleContext deve essere corrispondente a una chiamata successiva a FltReleaseContext.
Per impostare un contesto per un handle di flusso, chiamare FltSetStreamHandleContext
Per allocare un nuovo contesto, chiamare FltAllocateContext.
Per eliminare un contesto di handle di flusso, chiamare FltDeleteStreamHandleContext o FltDeleteContext.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | fltkernel.h (includere Fltkernel.h) |
| Libreria | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |