Функция WriteFileEx

Чтобы записать данные в файл синхронно, используйте функцию WriteFile.

Синтаксис

BOOL WriteFileEx(
  HANDLE hFile,                      // дескриптор файла вывода
  LPCVOID lpBuffer,                  // буфер данных
  DWORD nNumberOfBytesToWrite,       // число байтов для записи
  LPOVERLAPPED lpOverlapped,         // асинхронный буфер
  LPOVERLAPPED_COMPLETION_ROUTINE
              lpCompletionRoutine    // процедура завершения
);

Параметры

hFile

Windows NT/2000/XP: Этот параметр может быть любым дескриптором, открытым с флажком FILE_FLAG_OVERLAPPED функцией CreateFile, или дескриптором сокета, возвращенного функцией socket или accept.

Windows 95/98/Me: Этим параметром может быть коммуникационный ресурс, открытый с флажком FILE_FLAG_OVERLAPPED функцией CreateFile или дескриптором сокета, возвращенным socket или accept. Вы не можете исполнить асинхронные операции записи в почтовом ящике ядра Windows, в именованных каналах или дисковых файлах.

lpBuffer

nNumberOfBytesToWrite

lpOverlapped

Для файлов, которые поддерживают смещения байтов, Вы должны задать смещение байта так, чтобы начать писать в файл. Вы определяете это смещение, устанавливая члены Offset и OffsetHigh  структуры OVERLAPPED. Для файлов, которые не поддерживают, смещения байтов, члены Offset и OffsetHigh игнорируются.

Функция WriteFileEx использует члены Internal и InternalHigh структуры OVERLAPPED. Вы не должны менять значения этих членов структуры.

Структура данных OVERLAPPED должна оставаться допустимой в ходе операции записи. Она не должна быть переменной, которая может выйти из пределов видимости, когда происходит задержка завершения операции записи.

lpCompletionRoutine

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

Замечания

• Доступ  к файлу должен начинаться при смещениях байтов в пределах файла, которые должны быть целыми числами кратными размеру сектора тома. Чтобы выяснить размер сектора тома, вызовите функцию GetDiskFreeSpace.
• Доступ  к файлу должен быть с количеством байтов, которое является целым числом, кратным размеру сектора тома. Например, если размер сектора - 512 байтов, приложение может запросить для чтения и записи  512, 1024 или 2048 байтов, но не 335, 981 или 7171 байт.
• Адреса буферов для операций чтения и записи должны выравниваться кратно сектору (выравниваются адреса в памяти, которые являются целыми числами, кратными размеру сектора тома). Один из способов выравнивания буфера кратно сектору, является использование функции VirtualAlloc, которая назначает буфера. Эта функция выделяет память, выравнивая их по адресам, которые являются целыми числами, кратными размеру страницы памяти  системы. Поскольку размеры, и страницы памяти, и  сектора тома, являются степенью 2, память, выровненная кратно размеру страницы памяти системы также выравнивается кратно и размеру сектора тома.

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

Приложение использует функции MsgWaitForMultipleObjectsEx, WaitForSingleObjectEx, WaitForMultipleObjectsEx, SignalObjectAndWait и  SleepEx, чтобы войти в готовый к действию режим ожидания. Для получения дополнительной информации о готовых к действию состояниях ожидания и асинхронных операциях ввода - вывода обращайтесь к описанию этих функций и к главе Синхронизация.

Windows 95/98/Me: Ни ReadFileEx, ни WriteFileEx   последовательными портами коммуникации использоваться не могут. Однако, чтобы выполнить асинхронный обмен данными, Вы можете использовать функции ReadFile и WriteFile.

Смотри также 

Обзор Управление файлами,  Функции для файлового ввода-вывода (I/O), CancelIo, CreateFile, FileIOCompletionRoutine, MsgWaitForMultipleObjectsEx, OVERLAPPED, ReadFileEx, SetEndOfFile, SetErrorMode,  SleepEx, SignalObjectAndWait, WaitForMultipleObjectsEx, WaitForSingleObjectEx, WriteFile