Função FltGetCopyInformationFromCallbackData (fltkernel.h)

Artigo
02/06/2025

A rotina FltGetCopyInformationFromCallbackData recupera informações de cópia dos dados de retorno de chamada, se presentes. As informações de cópia estão na extensão IRP para chamadas de leitura/gravação provenientes de NtCopyFileChunk.

Sintaxe

NTSTATUS FLTAPI FltGetCopyInformationFromCallbackData(
  [in]  PFLT_CALLBACK_DATA Data,
  [out] PCOPY_INFORMATION  CopyInformation
);

Parâmetros

[in] Data

Ponteiro para uma estrutura FLT_CALLBACK_DATA que contém os dados de retorno de chamada.

[out] CopyInformation

Ponteiro para uma estrutura COPY_INFORMATION na qual as informações de cópia serão gravadas.

Valor de retorno

FltGetCopyInformationFromCallbackData retorna STATUS_SUCCESS após o sucesso ou um código de erro, como o seguinte.

Código de erro	Significado
STATUS_INVALID_PARAMETER	Os dados de retorno de chamada não são para uma operação IRP.
STATUS_NOT_FOUND	A extensão IRP de informações de cópia não foi definida no IRP.

Observações

Todas as operações de leitura ou gravação confiáveis de NtCopyFileChunk terão o seguinte:

O modo solicitante do IRP definido como kernelMode.
Uma extensão IRP com um tipo de IopCopyInformationType e informações sobre a operação de cópia.

Os filtros não têm acesso diretamente às extensões IRP, mas podem verificar a presença da extensão de cópia e obter informações de cópia chamando FltGetCopyInformationFromCallbackData.

Consulte cópia de arquivo no modo Kernel e detectando cenários de arquivo de cópia para obter mais informações.