Структура OVERLAPPED

Структура OVERLAPPED содержит информацию, используемую в асинхронном (или перекрывающем) вводе  и выводе данных (I/O).

Зарезервирован для использования операционной системой. Этот член структуры, который определяет системно-зависимое состояние, правильный тогда, когда функция GetOverlappedResult возвращает значение  ERROR_IO_PENDING без установки дополнительной информации об ошибке.

Зарезервирован для использования операционной системой. Этот член структуры, который устанавливает длину переданных данных, правильный тогда, когда функция GetOverlappedResult возвращений значение  TRUE.

Этот член структуры используется только тогда, когда устройство - файл. В противном случае, этот член структуры должен быть нуль.

Этот член структуры используется только тогда, когда устройство - файл. В противном случае, этот член структуры должен быть нуль.

Дескриптор события, которые должно быть установлено в сигнальное состояние, когда операция завершилась. Вызывающий процесс должен установить в этом члене структуры или нуль, или допустимый дескриптор события перед вызовом любых перекрывающих функций. Чтобы создать объект события, используйте функцию CreateEvent. Эта функция возвращает дескриптор, который может быть использован, чтобы синхронизировать одновременные запросы ввода - вывода (I/O) к устройству.

Функции типа ReadFile и WriteFile устанавливают этот дескриптор в несигнальное состояние прежде, чем они начинают операцию ввода-вывода (I/O). Когда операция завершается, дескриптор устанавливается в сигнальное состояние.

Функции типа GetOverlappedResult и функции ожидания сбрасывают  автосброс событий в несигнальное состояние. Поэтому, если Вы используете  автосброс события, ваше приложение может зависнуть, если Вы ожидаете операцию завершения, чтобы затем вызвать функцию GetOverlappedResult.

Эта структура должна всегда инициализироваться нулями прежде, чем она используется в вызове функции. Если этого не сделать, функция может завершить ошибкой и возвратить значение ERROR_INVALID_PARAMETER.

Вы можете использовать макрос HasOverlappedIoCompleted, чтобы выяснить, завершилась ли асинхронная операция ввода-вывода (I/O). Вы можете использовать функцию CancelIo, чтобы отменить асинхронную операцию ввода-вывода (I/O).

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