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 referenciar o IORING.

Sintaxe

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

Parâmetros

ioringVersion

Um UNIT32 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 é menor que duas vezes o tamanho real da fila de envio para permitir envios enquanto algumas operações ainda estão 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.

Retornar valor

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

Requisitos