Funzione FsRtlInsertPerStreamContext (ntifs.h)
La routine FsRtlInsertPerStreamContext associa la struttura del contesto per flusso di un driver di filtro del file system a un flusso di file.
Sintassi
NTSTATUS FsRtlInsertPerStreamContext(
PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
[in] PFSRTL_PER_STREAM_CONTEXT Ptr
);
Parametri
PerStreamContext
Puntatore alla struttura FSRTL_ADVANCED_FCB_HEADER per il flusso di file. Per ottenere questo puntatore da un oggetto file, utilizzare la macro FsRtlGetPerStreamContextPointer .
[in] Ptr
Puntatore a una struttura FSRTL_PER_STREAM_CONTEXT allocata e inizializzata dal driver di filtro. Per inizializzare questa struttura, utilizzare la macro FsRtlInitPerStreamContext .
Valore restituito
FsRtlInsertPerStreamContext restituisce uno dei valori NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
La chiamata a FsRtlInsertPerStreamContext ha avuto esito positivo. |
|
Il file system sottostante non supporta i contesti di filtro. |
Commenti
Un driver di filtro del file system chiama FsRtlInsertPerStreamContext per associare la propria struttura di contesto per flusso a un flusso di file. La struttura del contesto per flusso contiene informazioni di contesto che il driver di filtro gestisce per il flusso di file.
Dopo che la struttura del contesto per flusso è stata associata a un flusso di file, può essere recuperata chiamando FsRtlLookupPerStreamContext o rimossa chiamando FsRtlRemovePerStreamContext.
Per altre informazioni, vedere Tracking Per-Stream Context in a Legacy File System Filter Driver.For more information, see Tracking Per-Stream Context in a Legacy File System Filter Driver.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Aggiornamento cumulativo di Windows 2000 SP4; Windows XP |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Vedi anche
FsRtlGetPerStreamContextPointer