Función CreateIoRing (ioringapi.h)

Crea una nueva instancia de un par de colas de envío o finalización de anillo de E/S y devuelve un identificador para hacer referencia al IORING.

Sintaxis

HRESULT CreateIoRing(
  IORING_VERSION      ioringVersion,
  IORING_CREATE_FLAGS flags,
  UINT32              submissionQueueSize,
  UINT32              completionQueueSize,
  HIORING             *h
);

Parámetros

ioringVersion

Unit32 que representa la versión de la API de anillo de E/S para la que se crea el anillo. Este valor debe ser menor o igual que el valor recuperado de una llamada a QueryIoRingCapabilities.

flags

Valor de la enumeración IORING_CREATE_FLAGS que especifica marcas de creación.

submissionQueueSize

Tamaño de cola de envío mínimo solicitado. El sistema puede redondear el tamaño según sea necesario para asegurarse de que el tamaño real es una potencia de 2. Puede obtener el tamaño real de la cola asignada llamando a GetIoRingInfo. Puede obtener el tamaño máximo de la cola de envío en el sistema actual llamando a QueryIoRingCapabilities.

completionQueueSize

Tamaño mínimo solicitado de la cola de finalización. El sistema redondea este tamaño hasta una potencia de dos que no es inferior a dos veces el tamaño real de la cola de envío para permitir envíos mientras algunas operaciones siguen en curso. Puede obtener el tamaño real de la cola asignada llamando a GetIoRingInfo.

h

Recibe el identificador HIORING resultante, si la creación se realizó correctamente. El anillo HIORING devuelto debe cerrarse llamando a CloseIoRing, no CloseHandle, para liberar los recursos subyacentes para ioRING.

Valor devuelto

HrESULT, incluido, entre otros, los siguientes:

Valor	Descripción
S_OK	Correcto.
IORING_E_UNKNOWN_VERSION	La versión especificada en ioringVersion es desconocida.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Build 22000
Servidor mínimo compatible	Windows Build 22000
Encabezado	ioringapi.h