Funzione FsRtlInsertPerStreamContext (ntifs.h)

Articolo
02/26/2024

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
STATUS_SUCCESS	La chiamata a FsRtlInsertPerStreamContext ha avuto esito positivo.
STATUS_INVALID_DEVICE_REQUEST	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