Функция PostQueuedCompletionStatus помещает пакет завершения операции ввода - вывода в порт завершения I/O.
Синтаксис
BOOL PostQueuedCompletionStatus( HANDLE CompletionPort, // дескриптор порта завершен. I/O DWORD dwNumberOfBytesTransferred,// передаваемые байты ULONG_PTR dwCompletionKey, // код завершения LPOVERLAPPED lpOverlapped // буфер асинхронной операции ); |
Параметры
CompletionPort
[in] Дескриптор порта завершения I/O, в который должен поместиться пакет завершения ввода - вывода.dwNumberOfBytesTransferred
[in] Значение, которое возвращается параметру lpNumberOfBytesTransferred функции GetQueuedCompletionStatus.dwCompletionKey
[in] Значение, которое возвращается параметру lpCompletionKey функции GetQueuedCompletionStatus.lpOverlapped
[in] Значение, которое возвращается параметру lpOverlapped функции GetQueuedCompletionStatus.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Пакет завершения ввода - вывода должен соответствовать ожидающим обработки вызовам функции GetQueuedCompletionStatus. Функция GetQueuedCompletionStatus возвращает три значения, передаваемые при вызове функции PostQueuedCompletionStatus как второй, третий и четвертый параметры .Система не использует или проверяет правильность этих значений. В частности, параметру lpOverlapped нет нужды указывать на структуру OVERLAPPED.
Для получения дополнительной информации о параметрах dwNumberOfBytesTransferred, dwCompletionKey и lpOverlapped, смотри их описания в функции GetQueuedCompletionStatus и значения возвращаемые в них.
Смотри также
Обзор Управление файлами, Функции для файлового ввода-вывода (I/O), CreateIoCompletionPort, GetQueuedCompletionStatus, OVERLAPPED
Размещение и совместимость PostQueuedCompletionStatus |
||
К |
Windows XP |
Да |
л |
Windows 2000 Professional |
Да |
и |
Windows NT Workstation |
Да версии 3.51 и выше |
е |
Windows Me |
Нет |
н |
Windows 98 |
Нет |
т |
Windows 95 |
Нет |
С |
Windows Server 2003 |
Да |
е | Windows 2000 Server | Да |
р | Windows NT Server | Да версии 3.51 и выше |
в | ||
е | ||
р | ||
Используемая библиотека |
Kernel32.lib |
|
Используемая DLL | - | |
Заголовочный файл | ||
- объявлено в |
Winbase.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |