Función FsRtlInsertPerStreamContext (ntifs.h)

Artículo
12/21/2024

La rutina FsRtlInsertPerStreamContext asocia una estructura de contexto por secuencia del controlador de filtro del sistema de archivos con una secuencia de archivos.

Sintaxis

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

Parámetros

PerStreamContext

Puntero a la estructura FSRTL_ADVANCED_FCB_HEADER de la secuencia de archivos. Para obtener este puntero de un objeto de archivo, use la macro FsRtlGetPerStreamContextPointer.

[in] Ptr

Puntero a una estructura FSRTL_PER_STREAM_CONTEXT que el controlador de filtro ha asignado e inicializado. Para inicializar esta estructura, use la macro FsRtlInitPerStreamContext.

Valor devuelto

FsRtlInsertPerStreamContext devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La llamada a FsRtlInsertPerStreamContext se realizó correctamente.
STATUS_INVALID_DEVICE_REQUEST	El sistema de archivos subyacente no admite contextos de filtro.

Observaciones

Un controlador de filtro del sistema de archivos llama a FsRtlInsertPerStreamContext para asociar su propia estructura de contexto por secuencia con una secuencia de archivos. La estructura de contexto por secuencia contiene información de contexto que mantiene el controlador de filtro para la secuencia de archivos.

Después de asociar la estructura de contexto por secuencia a una secuencia de archivos, se puede recuperar llamando a FsRtlLookupPerStreamContext o quitando llamando a FsRtlRemovePerStreamContext.

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 de Windows 2000 SP4; Windows XP
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL