FltGetCopyInformationFromCallbackData, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetCopyInformationFromCallbackData récupère les informations de copie à partir des données de rappel, le cas échéant. Les informations de copie se situent dans l’extension IRP pour les appels en lecture/écriture provenant de NtCopyFileChunk.

Syntaxe

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

Paramètres

[in] Data

Pointeur vers une structure FLT_CALLBACK_DATA qui contient les données de rappel.

[out] CopyInformation

Pointeur vers une structure COPY_INFORMATION dans laquelle les informations de copie seront écrites.

Valeur de retour

FltGetCopyInformationFromCallbackData retourne STATUS_SUCCESS en cas de réussite, ou un code d’erreur tel que le suivant.

Code d’erreur	Signification
STATUS_INVALID_PARAMETER	Les données de rappel ne sont pas destinées à une opération IRP.
STATUS_NOT_FOUND	L’extension IRP des informations de copie n’a pas été définie sur l’IRP.

Remarques

Toutes les opérations de lecture ou d’écriture approuvées de NtCopyFileChunk disposeront des éléments suivants :

Le mode demandeur de l’IRP défini sur KernelMode.
Extension IRP avec un type IopCopyInformationType et des informations sur l’opération de copie.

Les filtres n’ont pas accès directement aux extensions IRP, mais peuvent rechercher la présence de l’extension de copie et obtenir des informations de copie en appelant FltGetCopyInformationFromCallbackData.

Pour plus d’informations, consultez copie de fichiers en mode noyau et détection des scénarios de copie de fichier.