Macro FsRtlSetupAdvancedHeaderEx (ntifs.h)

Artículo
12/21/2024

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

Sintaxis

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

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 FsRtlSetupAdvancedHeaderEx).

_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. En particular:

En el caso de los sistemas operativos Microsoft Windows publicados antes de Windows Vista, los autores de llamadas deben establecer este parámetro en NULL.
Para los sistemas operativos Windows a partir de Windows Vista: 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.

Valor devuelto

Ninguno

Observaciones

Los sistemas de archivos usan la macro FsRtlSetupAdvancedHeaderEx 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.

Requisitos

Requisito	Valor
cliente mínimo admitido	Paquete acumulativo de actualizaciones para Microsoft Windows 2000 Service Pack 4 (SP4); Windows XP
de la plataforma de destino de	Escritorio
encabezado de	ntifs.h (incluya Ntifs.h, Fltkernel.h)
irQL	PASSIVE_LEVEL