Функция SubmitIoRing (ioringapi.h)

Отправляет все созданные, но еще не отправленные записи в очередь ядра и при необходимости ожидает завершения набора операций.

Синтаксис

HRESULT SubmitIoRing(
  HIORING ioRing,
  UINT32  waitOperations,
  UINT32  milliseconds,
  UINT32  *submittedEntries
);

Параметры

ioRing

HIORING, представляющий дескриптор для круга ввода-вывода, для которого будут отправляться записи.

waitOperations

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

milliseconds

Количество миллисекундах для ожидания завершения операций. Укажите INFINITE , чтобы ждать неограниченное время. Это значение игнорируется, если для waitOperations задано значение 0.

submittedEntries

Необязательный элемент. Получает указатель на массив UINT_32 значений, представляющих количество отправленных записей.

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

Возвращает HRESULT, включая, помимо прочего, одно из следующих значений:

Значение	Описание:
S_OK	Все записи в очереди были отправлены без ошибок.
IORING_E_WAIT_TIMEOUT	Все операции были отправлены без ошибок, и время ожидания истекло.
Любое другое значение ошибки	Невозможно обработать очередь отправки в полном объеме.

Комментарии

Если эта функция возвращает ошибку, отличное от IORING_E_WAIT_TIMEOUT, все записи остаются в очереди отправки. Любые ошибки при обработке одной записи очереди отправки приводят к синхронному завершению этой записи, отправленной в очередь завершения с кодом состояния ошибки для этой операции.

Требования

Требование	Значение
Минимальная версия клиента	Сборка Windows 22000
Минимальная версия сервера	Сборка Windows 22000
Верхняя часть	ioringapi.h