Função FltSupportsFileContextsEx (fltkernel.h)

Artigo
08/07/2023

A rotina FltSupportsFileContextsEx determina se o sistema de arquivos ou o gerenciador de filtros dão suporte a contextos de arquivo para um determinado arquivo.

Sintaxe

BOOLEAN FLTAPI FltSupportsFileContextsEx(
  [in]           PFILE_OBJECT  FileObject,
  [in, optional] PFLT_INSTANCE Instance
);

Parâmetros

[in] FileObject

Ponteiro para o objeto de arquivo que representa o arquivo cujo suporte ao contexto de arquivo está sendo consultado. Esse parâmetro é necessário e não pode ser NULL.

[in, optional] Instance

Ponteiro de instância opaco para o chamador. Esse parâmetro é opcional e pode ser NULL. Para obter mais informações sobre esse parâmetro, consulte a seção Comentários desta página.

Retornar valor

FltSupportsFileContextsEx retornaráTRUE se o sistema de arquivos ou o gerenciador de filtros der suporte a contextos de arquivo para o arquivo; Caso contrário, FALSE.

Comentários

Os drivers de minifiltro podem chamar a rotina FltSupportsFileContextsEx para determinar se o sistema de arquivos subjacente ou o gerenciador de filtros dá suporte a contextos de arquivo para o arquivo representado por FileObject sem precisar alocar um contexto e tentar defini-lo. Se não houver suporte para um tipo de contexto em um arquivo, o minifiltro não poderá anexar um contexto a esse arquivo.

Para sistemas de arquivos (como FAT) que dão suporte apenas a um único fluxo de dados por arquivo, os contextos de arquivo são equivalentes a contextos de fluxo. Esses sistemas de arquivos geralmente dão suporte a contextos de fluxo, mas não dão suporte a contextos de arquivo. Em vez disso, o gerenciador de filtros fornece suporte ao contexto de arquivo, usando o suporte existente do sistema de arquivos para contextos de fluxo. Para instâncias de minifiltro anexadas a esses sistemas de arquivos, FltSupportsFileContexts retorna FALSE, enquanto FltSupportsFileContextsEx retorna TRUE (quando um valor não NULL válido é passado para o parâmetro Instance ).

Se um valor não NULL for fornecido para o parâmetro Instance , FltSupportsFileContextsEx retornaráTRUE se o sistema de arquivos ou o gerenciador de filtros der suporte a contextos de arquivo para o arquivo; Caso contrário, FALSE.

Se o parâmetro Instance for NULL, FltSupportsFileContextsEx retornará TRUE somente se o sistema de arquivos der suporte a contextos de arquivo para o arquivo. Caso contrário, ele retornará FALSE, mesmo que o gerenciador de filtros dê suporte a contextos de arquivo para o arquivo.

Observe que um sistema de arquivos pode dar suporte a contextos de arquivo para alguns tipos de arquivos, mas não para outros. Por exemplo, NTFS e FAT não dão suporte a contextos de arquivo para arquivos de paginação.

Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa rotina está disponível no Windows Vista e posterior.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL