Função FltRequestFileInfoOnCreateCompletion (fltkernel.h)

  • Artigo

Um minifiltro chama FltRequestFileInfoOnCreateCompletion durante a pré-criação de arquivo para solicitar que o gerenciador de arquivos armazene informações de arquivo para recuperação durante a pós-criação.

Sintaxe

NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
  PFLT_FILTER        Filter,
  PFLT_CALLBACK_DATA Data,
  ULONG              InfoClassFlags
);

Parâmetros

Filter

Ponteiro de filtro opaco que identifica exclusivamente o driver de minifiltro.

Data

Ponteiro para o FLT_CALLBACK_DATA dados de retorno de chamada que representam a operação de criação de E/S.

InfoClassFlags

Sinalizador bitmask indicando o tipo de informações de arquivo que o sistema de arquivos deve armazenar para recuperação durante a pós-criação. Pode ser qualquer combinação dos seguintes sinalizadores:

Sinalizador Significado
QoCFileStatInformation (0x00000001) Se definido, o sistema de arquivos armazenará informações de estatística de arquivo em uma estrutura QUERY_ON_CREATE_FILE_STAT_INFORMATION para recuperação.
QoCFileLxInformation (0x00000002) Se definido, o sistema de arquivos armazenará informações estendidas semelhantes ao Linux em uma estrutura QUERY_ON_CREATE_FILE_LX_INFORMATION para recuperação.
QoCFileEaInformation (0x00000004) Se definido, o sistema de arquivos armazenará atributos estendidos (EA) em uma estrutura QUERY_ON_CREATE_EA_INFORMATION para recuperação.

Retornar valor

FltRequestFileInfoOnCreateCompletion pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS O sistema de arquivos armazenou com êxito as informações de arquivo solicitadas.
STATUS_INSUFFICIENT_RESOURCES FltRequestFileInfoOnCreateCompletion não pôde alocar memória suficiente para armazenar as informações de arquivo solicitadas.
STATUS_INVALID_PARAMETER_2 O objeto de dados de retorno de chamada fornecido não era uma operação de criação baseada em IRP.

Comentários

O minifiltro pode recuperar as informações do arquivo chamando FltRetrieveFileInfoOnCreateCompletionEx ou FltRetrieveFileInfoOnCreateCompletion durante a pós-criação. O desempenho de um minifiltro normalmente é melhor quando ele solicita e recupera informações de arquivo dessa maneira, em vez de consultar informações de arquivo posteriormente.

Requisitos

Requisito Valor
Cabeçalho fltkernel.h (inclua Fltkernel.h)

Confira também

FLT_CALLBACK_DATA

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx