Funzione SubmitIoRing (ioringapi.h)

Invia tutte le voci costruite ma non ancora inviate alla coda del kernel e, facoltativamente, attende il completamento di un set di operazioni.

Sintassi

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

Parametri

ioRing

Hioring che rappresenta un handle all'anello di I/O per cui verranno inviate le voci.

waitOperations

Numero di voci della coda di completamento da attendere. Specificando 0 indica che la chiamata non deve attendere. Questo valore deve essere minore della somma del numero di voci nella coda di invio e del numero di operazioni attualmente in corso.

milliseconds

Numero di millisecondi da attendere il completamento delle operazioni. Specificare INFINITE per attendere in modo indefinito. Questo valore viene ignorato se viene specificato 0 per waitOperations.

submittedEntries

facoltativo. Riceve un puntatore a una matrice di valori UINT_32 che rappresentano il numero di voci inviate.

Valore restituito

Restituisce un valore HRESULT incluso, ma non limitato a, uno dei seguenti:

Commenti

Se questa funzione restituisce un errore diverso da IORING_E_WAIT_TIMEOUT, tutte le voci rimangono nella coda di invio. Eventuali errori durante l'elaborazione di una singola voce della coda di invio generano un completamento sincrono di tale voce pubblicata nella coda di completamento con un codice di stato di errore per tale operazione.

Requisiti