Funzione FltGetCopyInformationFromCallbackData (fltkernel.h)

Articolo
02/06/2025

La routine FltGetCopyInformationFromCallbackData recupera le informazioni di copia dai dati di callback, se presenti. Le informazioni di copia si trovano nell'estensione IRP per le chiamate di lettura/scrittura provenienti da NtCopyFileChunk.

Sintassi

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

Parametri

[in] Data

Puntatore a una struttura FLT_CALLBACK_DATA che contiene i dati di callback.

[out] CopyInformation

Puntatore a una struttura COPY_INFORMATION in cui verranno scritte le informazioni di copia.

Valore restituito

FltGetCopyInformationFromCallbackData restituisce STATUS_SUCCESS in caso di esito positivo o un codice di errore, ad esempio il seguente.

Codice di errore	Significato
STATUS_INVALID_PARAMETER	I dati di callback non sono destinati a un'operazione IRP.
STATUS_NOT_FOUND	L'estensione IRP delle informazioni di copia non è stata impostata su IRP.

Osservazioni

Qualsiasi operazione di lettura o scrittura attendibile da ntCopyFileChunk avrà quanto segue:

La modalità richiedente di IRP impostata su KernelMode.
Estensione IRP con un tipo IopCopyInformationType e informazioni sull'operazione di copia.

I filtri non hanno accesso direttamente alle estensioni IRP, ma possono verificare la presenza dell'estensione di copia e ottenere informazioni di copia chiamando FltGetCopyInformationFromCallbackData.

Per altre informazioni, vedere copia di file in modalità kernel e rilevamento di scenari di file di copia.