Compartilhar via


Função FltGetCopyInformationFromCallbackData (fltkernel.h)

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.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 11, versão 22H2
cabeçalho fltkernel.h
IRQL <= DISPATCH_LEVEL

Consulte também

COPY_INFORMATION

IoCheckFileObjectOpenedAsCopyDestination

IoCheckFileObjectOpenedAsCopySource

NtCopyFileChunk

NtCreateFile