Macro FsRtlGetPerStreamContextPointer (ntifs.h)

Artículo
02/29/2024

La macro FsRtlGetPerStreamContextPointer devuelve el contexto de secuencia del sistema de archivos para una secuencia de archivos.

Sintaxis

void FsRtlGetPerStreamContextPointer(
   _fo
);

Parámetros

_fo

Puntero a un objeto de archivo para la secuencia de archivos.

Valor devuelto

None

Observaciones

Los controladores de filtro del sistema de archivos pueden usar la macro FsRtlGetPerStreamContextPointer para obtener un puntero de contexto de secuencia para la secuencia de archivos representada por un objeto de archivo determinado. Un puntero de contexto de secuencia es un puntero al contexto de flujo del sistema de archivos para la secuencia de archivos. Este puntero se puede pasar como parámetro a FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContext y FsRtlRemovePerStreamContext.

El puntero de contexto de secuencia apunta a una estructura de FSRTL_ADVANCED_FCB_HEADER que identifica de forma única la secuencia de archivos al sistema de archivos. Esta estructura normalmente se inserta en un objeto de contexto de flujo, como un bloque de control de archivos (FCB) o un bloque de control de flujo (SCB). Cuando se abre la secuencia de archivos, el sistema de archivos almacena un puntero al FCB o SCB en el miembro FsContext del objeto de archivo.

Nota La macro FsRtlGetPerStreamContextPointer solo se puede usar en sistemas de archivos que admiten encabezados FCB avanzados.

Para obtener más información, vea Tracking Per-Stream Context in a Legacy File System Filter Driver.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP; Paquete acumulativo de actualizaciones de Windows 2000 SP4
Plataforma de destino	Escritorio
Encabezado	ntifs.h (incluya Ntifs.h)
IRQL	<= APC_LEVEL