Compartilhar via


Função FltRegisterForDataScan (fltkernel.h)

A rotina FltRegisterForDataScan permite a verificação de dados para o volume anexado à instância do minifiltro.

Sintaxe

NTSTATUS FLTAPI FltRegisterForDataScan(
  [in] PFLT_INSTANCE Instance
);

Parâmetros

[in] Instance

Um ponteiro de instância opaca para que a instância do driver de minifiltro se registre para verificação de dados.

Valor de retorno

FltRegisterForDataScan retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes.

Código de retorno Descrição
STATUS_NOT_SUPPORTED O gerenciador de filtros não dá suporte a verificações de dados para o volume anexado a essa instância.

Observações

Um minifiltro que faz a verificação de dados deve registrar seu volume para verificação chamando FltRegisterForDataScan antes de chamar FltCreateSectionForDataScan. Os minifiltros fazem verificações de dados por vários motivos, como detecção de vírus, criptografia ou compactação.

Nota

Se FltRegisterForDataScan retornar STATUS_NOT_SUPPORTED, um minifiltro ainda poderá criar seções para verificação de dados chamando FsRtlCreateSectionForDataScan. No entanto, o acesso à seção criada pelo FsRtlCreateSectionForDataScan não é sincronizado e é responsabilidade do minifiltro de chamada lidar com qualquer resolução de conflitos que surja. Esse minifiltro deve implementar e registrar uma rotina de retorno de chamada PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK que pode ser chamada quando ocorre um conflito de seção.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8
da Plataforma de Destino Universal
cabeçalho fltkernel.h (inclua Fltkernel.h)
biblioteca FltMgr.lib
de DLL Fltmgr.sys
IRQL <= APC_LEVEL

Consulte também

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FsRtlCreateSectionForDataScan

PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK