Função CreateIoRing (ioringapi.h)

Cria uma nova instância de um par de filas de envio/conclusão de anel de E/S e retorna um identificador para fazer referência ao IORING.

Sintaxe

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

Parâmetros

ioringVersion

Uma UNIDADE32 que representa a versão da API de anel de E/S para a qual o anel é criado. Esse valor deve ser menor ou igual ao valor recuperado de uma chamada para QueryIoRingCapabilities

flags

Um valor da enumeração IORING_CREATE_FLAGS especificando sinalizadores de criação.

submissionQueueSize

O tamanho mínimo da fila de envio solicitado. O sistema pode arredondar o tamanho conforme necessário para garantir que o tamanho real seja uma potência de 2. Você pode obter o tamanho real da fila alocada chamando GetIoRingInfo. Você pode obter o tamanho máximo da fila de envio no sistema atual chamando QueryIoRingCapabilities.

completionQueueSize

O tamanho mínimo solicitado da fila de conclusão. O sistema arredondará esse tamanho até uma potência de dois que não seja menos que duas vezes o tamanho real da fila de envio para permitir envios enquanto algumas operações ainda estiverem em andamento. Você pode obter o tamanho real da fila alocada chamando GetIoRingInfo.

h

Recebe o identificador HIORING resultante, se a criação foi bem-sucedida. O anel HIORING retornado deve ser fechado chamando CloseIoRing, não CloseHandle, para liberar os recursos subjacentes para o IORING.

Valor de retorno

Um HRESULT, incluindo, mas não se limitando ao seguinte:

Value	Description
S_OK	Êxito.
IORING_E_UNKNOWN_VERSION	A versão especificada em ioringVersion é desconhecida.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows Build 22000
Servidor mínimo compatível	Windows Build 22000
Header	ioringapi.h
Library	kernel32. Lib