Macro FsRtlGetPerStreamContextPointer (ntifs.h)

Articolo
02/07/2025

La macro FsRtlGetPerStreamContextPointer restituisce il contesto di flusso del file system per un flusso di file.

Sintassi

void FsRtlGetPerStreamContextPointer(
   _fo
);

Parametri

_fo

Puntatore a un oggetto file per il flusso di file.

Valore restituito

Nessuno

Osservazioni

I driver di filtro del file system possono usare la macro FsRtlGetPerStreamContextPointer per ottenere un puntatore di contesto di flusso per il flusso di file rappresentato da un determinato oggetto file. Un puntatore al contesto di flusso è un puntatore al contesto di flusso del file system per il flusso di file. Questo puntatore può essere passato come parametro a FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContexte FsRtlRemovePerStreamContext.

Il puntatore al contesto del flusso punta a una struttura FSRTL_ADVANCED_FCB_HEADER che identifica in modo univoco il flusso di file nel file system. Questa struttura è in genere incorporata in un oggetto contesto di flusso, ad esempio un blocco di controllo file (FCB) o un blocco di controllo di flusso (SCB). Quando il flusso di file viene aperto, il file system archivia un puntatore all'istanza FCB o SCB nel membro FsContext dell'oggetto file.

Nota La macro FsRtlGetPerStreamContextPointer può essere usata solo nei file system che supportano intestazioni FCB avanzate.

Per altre informazioni, vedere 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP; Aggiornamento cumulativo di Windows 2000 SP4
piattaforma di destinazione	Desktop
intestazione	ntifs.h (include Ntifs.h)
IRQL	<= APC_LEVEL