Función FsRtlInsertPerStreamContext (ntifs.h)
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 desde un objeto de archivo, use la macro FsRtlGetPerStreamContextPointer .
[in] Ptr
Puntero a una estructura de 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 |
|---|---|
|
La llamada a FsRtlInsertPerStreamContext se realizó correctamente. |
|
El sistema de archivos subyacente no admite contextos de filtro. |
Comentarios
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 mediante una llamada a FsRtlRemovePerStreamContext.
Para obtener más información, vea Seguimiento de Per-Stream contexto en un controlador de filtro del sistema de archivos heredado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Paquete acumulativo de actualizaciones de Windows 2000 SP4; Windows XP |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte también
FsRtlGetPerStreamContextPointer