Поделиться через


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

Закрывает дескриптор HIORING , который ранее был открыт с помощью вызова CreateIoRing.

Синтаксис

HRESULT CloseIoRing(
  HIORING ioRing
);

Параметры

ioRing

Закрываемая дескриптор HIORING .

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

Возвращает S_OK при успешном выполнении.

Комментарии

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

Возможно, что операции чтения или записи в буферы памяти могут по-прежнему выполняться после возврата CloseIoRing . Если вы хотите убедиться в отсутствии ожидающих операций чтения или записи, необходимо дождаться появления завершений в очереди завершения для всех отправленных операций. Вы можете отменить ранее отправленные операции, прежде чем ожидать их завершения. В качестве альтернативы отправке нескольких запросов на отмену можно вызвать CancelIoEx с дескриптором файла и значением NULL для перекрывающегося указателя, чтобы эффективно отменить все ожидающие операции с дескриптором.

Требования

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