Funzione FsRtlSetupAdvancedHeader (ntifs.h)

Articolo
12/21/2024

La macro FsRtlSetupAdvancedHeader viene utilizzata dai file system per inizializzare una struttura FSRTL_ADVANCED_FCB_HEADER da utilizzare 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 rapido deve essere allocato dal pool non di paging.

Questo parametro 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 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 utilizzare 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 per flusso 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.