Funzione SubmitIoRing (ioringapi.h)

Articolo
08/24/2023

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:

Valore	Descrizione
S_OK	Tutte le voci nella coda sono state inviate senza errori.
IORING_E_WAIT_TIMEOUT	Tutte le operazioni sono state inviate senza errori e il timeout di attesa successivo.
Qualsiasi altro valore di errore	Non è possibile elaborare la coda di invio nell'intera area.

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

Requisito	Valore
Client minimo supportato	Windows Build 22000
Server minimo supportato	Windows Build 22000
Intestazione	ioringapi.h

Condividi tramite