Macro FsRtlLookupPerStreamContext (ntifs.h)

Artigo
03/08/2023

A macro FsRtlLookupPerStreamContext recupera uma estrutura de contexto por fluxo para um fluxo de arquivos.

Sintaxe

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Parâmetros

_sc

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 .

_oid

Ponteiro para uma variável alocada pelo chamador que identifica exclusivamente o proprietário da estrutura de contexto por fluxo. O formato dessa variável é driver de filtro – específico. Deve ser não NULL se um valor não NULL for fornecido para InstanceId.

_iid

Ponteiro para um driver de filtro – variável alocada que pode ser usada para distinguir entre as estruturas de contexto por fluxo criadas pelo mesmo driver de filtro. O formato dessa variável é driver de filtro – específico.

Se OwnerId e InstanceId forem NULL, FsRtlLookupPerStreamContext retornará o primeiro contexto por fluxo encontrado.

Se um valor não NULL for fornecido para OwnerId e InstanceId for NULL, FsRtlLookupPerStreamContext retornará o primeiro contexto por fluxo encontrado cujo membro OwnerId corresponde ao parâmetro OwnerId .

Retornar valor

Nenhum

Comentários

Um driver de filtro do sistema de arquivos chama FsRtlLookupPerStreamContext para recuperar sua estrutura de contexto por fluxo para 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.

ObservaçãoFsRtlLookupPerStreamContext só pode ser usado em sistemas de arquivos que dão suporte a contextos por fluxo.

Para inicializar uma estrutura de contexto por fluxo, use a macro FsRtlInitPerStreamContext .

Para associar uma estrutura de contexto por fluxo inicializada a um fluxo de arquivos, chame FsRtlInsertPerStreamContext.

Para remover uma estrutura de contexto por fluxo associada a um fluxo de arquivos, chame 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	Área de Trabalho
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL