Função FsRtlLookupPerFileObjectContext (ntifs.h)

Artigo
12/21/2024

Para um driver de filtro do sistema de arquivos "herdado", a função FsRtlLookupPerFileObjectContext recupera informações de contexto anteriormente associadas a um objeto de arquivo.

Sintaxe

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Parâmetros

[in] FileObject

Um ponteiro para um objeto de arquivo para o qual consultar informações de contexto.

[in, optional] OwnerId

Um ponteiro para uma variável alocada por chamador que identifica exclusivamente o filtro proprietário da estrutura de contexto por objeto de arquivo. O formato dessa variável é específico do driver de filtro.

[in, optional] InstanceId

Um ponteiro para uma variável alocada por chamador que pode ser usada para distinguir entre as estruturas de contexto por objeto de arquivo criadas pelo mesmo driver de filtro. O formato dessa variável é específico do driver de filtro. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

FsRtlLookupPerFileObjectContext retorna um ponteiro para o primeiro contexto correspondente por arquivo-objeto encontrado. Se nenhuma correspondência for encontrada, FsRtlLookupPerFileObjectContext retornará NULL.

Observações

Um driver de filtro do sistema de arquivos "herdado" chama FsRtlLookupPerFileObjectContext para recuperar sua estrutura de contexto por arquivo-objeto para um objeto de arquivo. A estrutura de contexto contém informações de contexto que o driver de filtro mantém para o objeto de arquivo. Essa estrutura de contexto deve ter sido associada anteriormente ao objeto de arquivo chamando a função FsRtlInsertPerFileObjectContext.

Se a estrutura FSRTL_PER_FILEOBJECT_CONTEXT estiver inserida em uma estrutura de contexto de objeto por arquivo definida por filtro, a macro CONTAINING_RECORD poderá ser usada para obter um ponteiro para a cabeça da estrutura definida pelo filtro.

Para inicializar uma estrutura de contexto por arquivo-objeto, use a macro FsRtlInitPerFileObjectContext.

Para associar uma estrutura de contexto por arquivo-objeto inicializada a um objeto de arquivo, use a função FsRtlInsertPerFileObjectContext.

Para remover uma estrutura de contexto por arquivo-objeto associada a um objeto de arquivo, use a função FsRtlRemovePerFileObjectContext.

Observação Os drivers de minifiltro do sistema de arquivos não devem usar as funções FsRtlXxxPerFileObjectContext. Em vez disso, os minifiltros podem usar as funções FltXxxContext para associar informações de contexto a um objeto de arquivo. Para obter uma lista completa, consulte o tópico FSRTL_PER_FILEOBJECT_CONTEXT.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Fltkernel.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext

Compartilhar via