Macro FsRtlSetupAdvancedHeaderEx (ntifs.h)

Articolo
12/22/2024

La macro FsRtlSetupAdvancedHeaderEx viene utilizzata dai file system per inizializzare una struttura FSRTL_ADVANCED_FCB_HEADER da utilizzare con contesti di flusso e di file.

Sintassi

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

Parametri

_advhdr

Puntatore alla struttura FSRTL_ADVANCED_FCB_HEADER da inizializzare.

_fmutx

Puntatore a un mutex rapido inizializzato che verrà usato per sincronizzare l'accesso a determinati membri FSRTL_ADVANCED_FCB_HEADER. Il mutex rapido deve essere allocato dal pool non di paging. Questo parametro è facoltativo e può essere NULL. I chiamanti devono impostare questo parametro su NULL se intendono usare un oggetto mutex veloce già esistente. Se FastMutex è NULL, il chiamante deve impostare in modo esplicito il membro FastMutex della struttura di FSRTL_ADVANCED_FCB_HEADER, contenuto nell'oggetto contesto del flusso, per puntare al mutex rapido esistente. Questa operazione può essere eseguita prima o dopo aver chiamato FsRtlSetupAdvancedHeaderEx.)

_fctxptr

Puntatore a un campo puntatore usato dalla libreria di runtime del file system (FSRTL) per tenere traccia dei contesti di file. Questo parametro è facoltativo e può essere NULL. Soprattutto:

Per i sistemi operativi Microsoft Windows rilasciati prima di Windows Vista, i chiamanti devono impostare questo parametro su NULL.
Per i sistemi operativi Windows a partire da Windows Vista: se FileContextSupportPointer non è NULL, FileContextSupportPointer deve essere un puntatore a una variabile PVOID all'interno di una struttura per file per il file system che ha creato la struttura. Per indicare che il driver del file system non supporta i contesti di file, i chiamanti devono impostare fileContextSupportPointer su NULL.

Valore restituito

Nessuno

Osservazioni

I file system usano la macro FsRtlSetupAdvancedHeaderEx per inizializzare una struttura FSRTL_ADVANCED_FCB_HEADER da usare con contesti di flusso e file.

Quando la struttura di intestazione FCB avanzata non è più necessaria, il file system deve chiamare FsRtlTeardownPerStreamContexts per liberare tutte le strutture di flusso e contesto di file associate.

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	Aggiornamento cumulativo per Microsoft Windows 2000 Service Pack 4 (SP4); Windows XP
piattaforma di destinazione	Desktop
intestazione	ntifs.h (include Ntifs.h, Fltkernel.h)
IRQL	PASSIVE_LEVEL