Функция PostQueuedCompletionStatus

  • Статья

Отправляет пакет завершения ввода-вывода на порт завершения ввода-вывода.

Синтаксис

BOOL WINAPI PostQueuedCompletionStatus(
  _In_     HANDLE       CompletionPort,
  _In_     DWORD        dwNumberOfBytesTransferred,
  _In_     ULONG_PTR    dwCompletionKey,
  _In_opt_ LPOVERLAPPED lpOverlapped
);

Параметры

CompletionPort [in]

Дескриптор порта завершения ввода-вывода, в который будет отправлен пакет завершения ввода-вывода.

dwNumberOfBytesTransferred [in]

Значение, возвращаемое с помощью параметра lpNumberOfBytesTransferred функции GetQueuedCompletionStatus .

dwCompletionKey [in]

Значение, возвращаемое с помощью параметра lpCompletionKey функции GetQueuedCompletionStatus .

lpOverlapped [in, необязательно]

Значение, возвращаемое с помощью параметра lpOverlapped функции GetQueuedCompletionStatus .

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError .

Комментарии

Пакет завершения ввода-вывода удовлетворяет незавершенный вызов функции GetQueuedCompletionStatus . Эта функция возвращает с тремя значениями, переданными в качестве второго, третьего и четвертого параметров вызова PostQueuedCompletionStatus. Система не использует и не проверяет эти значения. В частности, параметр lpOverlapped не должен указывать на структуру OVERLAPPED .

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология Поддерживается
Протокол SMB 3.0
 Да
Прозрачная отработка отказа (TFO) SMB 3.0
 Да
SMB 3.0 с масштабируемыми общими папками (SO)
 Да
Файловая система общего тома кластера (CSVFS)
 Да
Восстанавливаемая файловая система (ReFS)
 Да

CsvFs выполняет перенаправление операций ввода-вывода для сжатых файлов.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера
 Windows Server 2003 [классические приложения | Приложения UWP]
Заголовок
IoAPI.h (включая Windows.h);
WinBase.h в Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP (включая Windows.h)
Библиотека
Kernel32.lib
DLL
Kernel32.dll

См. также

CreateIoCompletionPort

Функции управления файлами

GetQueuedCompletionStatus

ПЕРЕКРЫВАЮЩИХСЯ