Функция PostQueuedCompletionStatus (ioapiset.h)

  • Статья

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

Синтаксис

BOOL PostQueuedCompletionStatus(
  [in]           HANDLE       CompletionPort,
  [in]           DWORD        dwNumberOfBytesTransferred,
  [in]           ULONG_PTR    dwCompletionKey,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Параметры

[in] CompletionPort

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

[in] dwNumberOfBytesTransferred

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

[in] dwCompletionKey

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

[in, optional] lpOverlapped

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

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

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

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

Комментарии

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

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

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

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header ioapiset.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

CreateIoCompletionPort

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

GetQueuedCompletionStatus

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