Macro FsRtlGetPerStreamContextPointer (ntifs.h)

Articolo
02/29/2024

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 utilizzare la macro FsRtlGetPerStreamContextPointer per ottenere un puntatore al contesto del flusso 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, FsRtlLookupPerStreamContext e 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 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	Windows XP; Aggiornamento cumulativo di Windows 2000 SP4
Piattaforma di destinazione	Desktop
Intestazione	ntifs.h (include Ntifs.h)
IRQL	<= APC_LEVEL