Macro FsRtlSetupAdvancedHeaderEx2 (ntifs.h)

Artículo
12/21/2024

Los sistemas de archivos usan la macro de FsRtlSetupAdvancedHeaderEx2 para inicializar una estructura de FSRTL_ADVANCED_FCB_HEADER para su uso con contextos de secuencia y archivo.

Sintaxis

void FsRtlSetupAdvancedHeaderEx2(
   _advhdr,
   _fmutx,
   _fctxptr,
   _aepushlock
);

Parámetros

_advhdr

Puntero a la estructura FSRTL_ADVANCED_FCB_HEADER que se va a inicializar.

_fmutx

Puntero a una exclusión mutua rápida inicializada que se usará para sincronizar el acceso a determinados miembros de FSRTL_ADVANCED_FCB_HEADER. La exclusión mutua rápida debe asignarse desde un grupo no paginado. Este parámetro es opcional y se puede 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 de la estructura de FSRTL_ADVANCED_FCB_HEADER, incluido en el objeto de contexto de flujo, para que apunte a la exclusión mutua rápida existente. (Esto se puede hacer antes o después de llamar a FsRtlSetupAdvancedHeaderEx2).

_fctxptr

Puntero a un campo de puntero utilizado por la biblioteca en tiempo de ejecución del sistema de archivos (FSRTL) para realizar un seguimiento de los contextos de archivo. Este parámetro es opcional y se puede NULL. Si FileContextSupportPointer no es NULL, FileContextSupportPointer debe ser un puntero a una variable PVOID dentro de una estructura por archivo para el sistema de archivos que creó la estructura. Para indicar que el controlador del sistema de archivos no admite contextos de archivo, los llamadores deben establecer FileContextSupportPointer en null.

_aepushlock

Puntero a una estructura opaca utilizada para inicializar el campo AePushLock del encabezado avanzado . El autor de la llamada de esta función es responsable de asignar e inicializar primero la memoria de este campo llamando a FsRtlAllocateAePushLocky, posteriormente, liberando la memoria llamando a FsRtlFreeAePushLock. Consulte FSRTL_ADVANCED_FCB_HEADER para obtener más información sobre los bloqueos de inserción de expansión automática.

Valor devuelto

Ninguno

Observaciones

Los sistemas de archivos usan la macro FsRtlSetupAdvancedHeaderEx2 para inicializar una estructura de FSRTL_ADVANCED_FCB_HEADER para su uso con contextos de secuencia y archivo.

Cuando la estructura avanzada de encabezado FCB ya no es necesaria, el sistema de archivos debe llamar a FsRtlTeardownPerStreamContexts liberar todas las estructuras de flujo y contexto de archivo asociadas.

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