Função FsRtlInsertPerStreamContext (ntifs.h)

Artigo
03/08/2023

A rotina FsRtlInsertPerStreamContext associa a estrutura de contexto por fluxo de um driver de filtro do sistema de arquivos a um fluxo de arquivos.

Sintaxe

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

Parâmetros

PerStreamContext

Ponteiro para a estrutura FSRTL_ADVANCED_FCB_HEADER para o fluxo de arquivos. Para obter esse ponteiro de um objeto de arquivo, use a macro FsRtlGetPerStreamContextPointer .

[in] Ptr

Ponteiro para uma estrutura FSRTL_PER_STREAM_CONTEXT que o driver de filtro alocou e inicializou. Para inicializar essa estrutura, use a macro FsRtlInitPerStreamContext .

Retornar valor

FsRtlInsertPerStreamContext retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A chamada para FsRtlInsertPerStreamContext foi bem-sucedida.
STATUS_INVALID_DEVICE_REQUEST	O sistema de arquivos subjacente não dá suporte a contextos de filtro.

Comentários

Um driver de filtro do sistema de arquivos chama FsRtlInsertPerStreamContext para associar sua própria estrutura de contexto por fluxo a um fluxo de arquivos. A estrutura de contexto por fluxo contém informações de contexto que o driver de filtro mantém para o fluxo de arquivos.

Depois que a estrutura de contexto por fluxo tiver sido associada a um fluxo de arquivos, ela poderá ser recuperada chamando FsRtlLookupPerStreamContext ou removida chamando FsRtlRemovePerStreamContext.

Para obter mais informações, consulte Acompanhamento Per-Stream contexto em um driver de filtro do sistema de arquivos herdado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Pacote cumulativo de atualizações do Windows 2000 SP4; Windows XP
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL