Функция FltGetCopyInformationFromCallbackData (fltkernel.h)
Подпрограмма FltGetCopyInformationFromCallbackData извлекает сведения о копировании из данных обратного вызова, если они есть. Сведения о копировании содержатся в расширении IRP для вызовов чтения и записи, поступающих из NtCopyFileChunk.
Синтаксис
NTSTATUS FLTAPI FltGetCopyInformationFromCallbackData(
[in] PFLT_CALLBACK_DATA Data,
[out] PCOPY_INFORMATION CopyInformation
);
Параметры
[in] Data
Указатель на FLT_CALLBACK_DATA структуру, содержащую данные обратного вызова.
[out] CopyInformation
Указатель на структуру COPY_INFORMATION , в которую будут записываться сведения о копировании.
Возвращаемое значение
FltGetCopyInformationFromCallbackData возвращает STATUS_SUCCESS при успешном выполнении, или код ошибки, подобный приведенному ниже.
| Код ошибки | Значение |
|---|---|
| STATUS_INVALID_PARAMETER | Данные обратного вызова не являются для операции IRP. |
| STATUS_NOT_FOUND | Расширение IRP для копирования сведений о копировании не было задано для IRP. |
Комментарии
Все доверенные операции чтения или записи из NtCopyFileChunk будут иметь следующие компоненты:
- Для режима инициатора запроса IRP задано значение KernelMode.
- Расширение IRP с типом IopCopyInformationType и сведениями об операции копирования.
Фильтры не имеют доступа к расширениям IRP напрямую, но могут проверка для наличия расширения копирования и получения сведений о копировании, вызвав FltGetCopyInformationFromCallbackData.
Дополнительные сведения см. в разделе Копирование файлов в режиме ядра и обнаружение сценариев копирования файлов .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 11 версии 22H2 |
| Верхняя часть | fltkernel.h |
| IRQL | <= DISPATCH_LEVEL |
См. также раздел
IoCheckFileObjectOpenedAsCopyDestination