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

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

Valor de retorno

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

Value	Description
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.

Observações

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 código de status de erro para essa operação.

Requirements

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