Función FsRtlSetupAdvancedHeader (ntifs.h)

Artículo
12/21/2024

Los sistemas de archivos usan la macro FsRtlSetupAdvancedHeader para inicializar una estructura de FSRTL_ADVANCED_FCB_HEADER para su uso con contextos de filtro.

Sintaxis

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Parámetros

AdvHdr

Puntero a la estructura FSRTL_ADVANCED_FCB_HEADER que se va a inicializar.

FMutex

Puntero a una exclusión mutua rápida inicializada que se usará para sincronizar el acceso a la estructura de FSRTL_ADVANCED_FCB_HEADER. La exclusión mutua rápida debe asignarse desde un grupo no paginado.

Este parámetro puede ser null. Los autores de llamadas deben establecer este parámetro en NULL si piensan usar un objeto de exclusión mutua rápida ya existente. Si fastMutex es NULL, el autor de la llamada debe establecer explícitamente el miembro FastMutex del objeto de contexto de secuencia para que apunte a la exclusión mutua rápida existente. (Esto se puede hacer antes o después de llamar a FsRtlSetupAdvancedHeader).

Valor devuelto

Ninguno

Observaciones

Los sistemas de archivos usan la macro FsRtlSetupAdvancedHeader para inicializar una estructura de FSRTL_ADVANCED_FCB_HEADER para su uso con contextos de filtro.

Cuando ya no se requiere la estructura avanzada de encabezado FCB, el sistema de archivos debe llamar a FsRtlTeardownPerStreamContexts liberar todas las estructuras de contexto por secuencia asociadas.

Para obtener más información, vea Per-Stream Contexto de seguimiento en un controlador de filtro del sistema de archivos heredado.