Macro FsRtlSetupAdvancedHeaderEx (ntifs.h)

Articolo
08/07/2023

La macro FsRtlSetupAdvancedHeaderEx viene utilizzata dai file system per inizializzare una struttura FSRTL_ADVANCED_FCB_HEADER da utilizzare con contesti di flusso e 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 da un 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 FSRTL_ADVANCED_FCB_HEADER , contenuto nell'oggetto contesto del flusso, per puntare al mutex rapido esistente. Questa operazione può essere eseguita prima o dopo la chiamata a 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. In particolare:

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 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 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