Função FltRegisterForDataScan (fltkernel.h)

  • Artigo

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

Sintaxe

NTSTATUS FLTAPI FltRegisterForDataScan(
  [in] PFLT_INSTANCE Instance
);

Parâmetros

[in] Instance

Um ponteiro de instância opaco para a instância de driver de minifiltro registrar para verificação de dados.

Retornar valor

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.

Comentários

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.

Observação

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 por FsRtlCreateSectionForDataScan não é sincronizado e é responsabilidade do minifiltro chamar lidar com qualquer resolução de conflitos que surja. Esse minifiltro deve implementar e registrar um PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK rotina de retorno de chamada que pode ser chamada quando ocorre conflito de seção.

Requisitos

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

Confira também

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FsRtlCreateSectionForDataScan

PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK