FltGetCopyInformationFromCallbackData-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetCopyInformationFromCallbackData Routine ruft Kopierinformationen aus den Rückrufdaten ab, sofern vorhanden. Die Kopierinformationen befinden sich in der IRP-Erweiterung für Lese-/Schreibaufrufe, die von NtCopyFileChunkstammen.

Syntax

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

Parameter

[in] Data

Zeigen Sie auf eine FLT_CALLBACK_DATA Struktur, die die Rückrufdaten enthält.

[out] CopyInformation

Zeigen Sie auf eine COPY_INFORMATION Struktur, in die die Kopierinformationen geschrieben werden.

Rückgabewert

FltGetCopyInformationFromCallbackData gibt nach Erfolg STATUS_SUCCESS oder einen Fehlercode wie den folgenden zurück.

Fehlercode	Bedeutung
STATUS_INVALID_PARAMETER	Die Rückrufdaten sind nicht für einen IRP-Vorgang vorgesehen.
STATUS_NOT_FOUND	Die IRP-Erweiterung zum Kopieren von Informationen wurde für das IRP nicht festgelegt.

Bemerkungen

Alle vertrauenswürdigen Lese- oder Schreibvorgänge aus NtCopyFileChunk- haben folgendes:

Der Anforderermodus des IRP wird auf KernelMode-festgelegt.
Eine IRP-Erweiterung mit einem IopCopyInformationType Typ und Informationen zum Kopiervorgang.

Filter haben keinen direkten Zugriff auf IRP-Erweiterungen, können aber überprüfen, ob die Kopiererweiterung vorhanden ist, und Kopierinformationen abrufen, indem sie FltGetCopyInformationFromCallbackDataaufrufen.

Weitere Informationen finden Sie unter Kernelmodusdateikopie und Erkennen von Kopierdateiszenarien.