Fonction FltGetCopyInformationFromCallbackData (fltkernel.h)

Article
02/29/2024

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 retournée

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 auront les éléments suivants :

Le mode demandeur de l’IRP est 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 case activée pour 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 fichier de copie .