Funzione FsRtlSetupAdvancedHeader (ntifs.h)

Articolo
03/08/2023

La macro FsRtlSetupAdvancedHeader viene usata dai file system per inizializzare una struttura FSRTL_ADVANCED_FCB_HEADER da usare con contesti di filtro.

Sintassi

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Parametri

AdvHdr

Puntatore alla struttura FSRTL_ADVANCED_FCB_HEADER da inizializzare.

FMutex

Puntatore a un mutex rapido inizializzato che verrà usato per sincronizzare l'accesso alla struttura FSRTL_ADVANCED_FCB_HEADER . Il mutex veloce deve essere allocato dal pool non con pagine.

Questo parametro può essere NULL. I chiamanti devono impostare questo parametro su NULL se intendono usare un oggetto mutex rapido già esistente. Se FastMutex è NULL, il chiamante deve impostare in modo esplicito il membro FastMutex dell'oggetto contesto di flusso per puntare al mutex rapido esistente. Questa operazione può essere eseguita prima o dopo aver chiamato FsRtlSetupAdvancedHeader.

Valore restituito

nessuno

Osservazioni

I file system usano la macro FsRtlSetupAdvancedHeader per inizializzare una struttura FSRTL_ADVANCED_FCB_HEADER da usare con contesti di filtro.

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

Per altre informazioni, vedere Rilevamento Per-Stream contesto in un driver di filtro del file system legacy.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Piattaforma di destinazione	Desktop
Intestazione	ntifs.h (include Ntifs.h, Fltkernel.h)
IRQL	<= APC_LEVEL