Função SubmitIoRing (ioringapi.h)

Envia todas as entradas construídas, mas ainda não enviadas, para a fila do kernel e, opcionalmente, aguarda a conclusão de um conjunto de operações.

Sintaxe

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

Parâmetros

ioRing

Um HIORING que representa um identificador para o anel de E/S para o qual as entradas serão enviadas.

waitOperations

O número de entradas da fila de conclusão a aguardar. Especificar 0 indica que a chamada não deve esperar. Esse valor deve ser menor que a soma do número de entradas na fila de envio e o número de operações em andamento no momento.

milliseconds

O número de milissegundos a aguardar a conclusão das operações. Especifique INFINITE para aguardar indefinidamente. Esse valor será ignorado se 0 for especificado para waitOperations.

submittedEntries

Opcional. Recebe um ponteiro para uma matriz de valores UINT_32 que representam o número de entradas enviadas.

Retornar valor

Retorna um HRESULT incluindo, mas não se limitando a, um dos seguintes:

Valor	Descrição
S_OK	Todas as entradas na fila foram enviadas sem erros.
IORING_E_WAIT_TIMEOUT	Todas as operações foram enviadas sem erro e a espera subsequente atingiu o tempo limite.
Qualquer outro valor de erro	Falha ao processar a fila de envio em sua totalidade.

Comentários

Se essa função retornar um erro diferente de IORING_E_WAIT_TIMEOUT, todas as entradas permanecerão na fila de envio. Qualquer erro ao processar uma única entrada de fila de envio resulta em uma conclusão síncrona dessa entrada postada na fila de conclusão com um erro status código para essa operação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Build 22000
Servidor mínimo com suporte	Windows Build 22000
Cabeçalho	ioringapi.h