Функция CcCopyWrite (ntifs.h)

Статья
12/20/2024

Программа CcCopyWrite копирует данные из буфера пользователя в кэшированный файл.

Синтаксис

BOOLEAN CcCopyWrite(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] BOOLEAN        Wait,
  [in] PVOID          Buffer
);

Параметры

[in] FileObject

Указатель на объект файла для кэшированного файла, в который записываются данные.

[in] FileOffset

Указатель на переменную, указывающую начальное смещение байтов в кэшированном файле.

[in] Length

Длина в байтах записываемых данных.

[in] Wait

Установите значение TRUE, если вызывающий объект может быть помещен в состояние ожидания до тех пор, пока все данные не будут скопированы, false в противном случае.

[in] Buffer

Указатель на буфер, из которого копируются данные.

Возвращаемое значение

Подпрограмма CcCopyWrite возвращает TRUE, если данные были успешно скопированы, FALSE в противном случае.

Замечания

Если ожиданиеTRUE, CcCopyWrite гарантированно завершит запрос копирования и возврат TRUE. Если необходимые страницы кэшированного файла уже находятся в памяти, данные будут скопированы немедленно, и блокировка не будет возникать. Если все необходимые страницы не являются резидентами, вызывающий объект будет помещен в состояние ожидания до тех пор, пока все необходимые страницы не были сделаны резидентами и данные можно скопировать.

Если ожиданиеfalse, CcCopyWrite откажется от блокировки и вернет FALSE, если требуемые страницы кэшированного файла еще не находятся в памяти или если флаг FO_WRITE_THROUGH установлен в объекте файла.

Если возникает сбой, CcCopyWrite вызывает исключение состояния для конкретного сбоя. Например, если возникает сбой выделения пула, CcCopyWrite вызывает исключение STATUS_INSUFFICIENT_RESOURCES; Если возникает ошибка ввода-вывода, CcCopyWrite вызывает исключение состояния ошибки ввода-вывода. Таким образом, чтобы получить контроль при возникновении сбоя, драйвер должен упаковать вызов CcCopyWrite в , кроме или инструкции try-finally.

Чтобы кэшировать файл, используйте CcInitializeCacheMap.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h, FltKernel.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

CcInitializeCacheMap

Поделиться через