Função FltGetCopyInformationFromCallbackData (fltkernel.h)

Artigo
03/01/2024

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.

Retornar valor

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

Código do 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.

Comentários

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

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

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

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