Função FltSupportsFileContextsEx (fltkernel.h)

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

Confira também

FltAllocateContext

FltDeleteContext

FltDeleteFileContext

FltGetFileContext

FltReleaseContext

FltSetFileContext

FltSupportsFileContexts