Condividi tramite

Funzione CreateIoRing (ioringapi.h)

  • Articolo

Crea una nuova istanza di una coppia di coda di invio/completamento dell'anello di I/O e restituisce un handle per fare riferimento a IORING.

Sintassi

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

Parametri

ioringVersion

Unità32 che rappresenta la versione dell'API dell'anello di I/O per cui viene creato l'anello. Questo valore deve essere minore o uguale al valore recuperato da una chiamata a QueryIoRingCapabilities

flags

Valore dell'enumerazione IORING_CREATE_FLAGS che specifica i flag di creazione.

submissionQueueSize

Dimensione minima della coda di invio richiesta. Il sistema può arrotondare le dimensioni in base alle esigenze per garantire che la dimensione effettiva sia una potenza di 2. È possibile ottenere le dimensioni effettive della coda allocata chiamando GetIoRingInfo. È possibile ottenere le dimensioni massime della coda di invio nel sistema corrente chiamando QueryIoRingCapabilities.

completionQueueSize

Dimensione minima richiesta della coda di completamento. Il sistema arrotonderà questa dimensione fino a una potenza di due che non è inferiore a due volte la dimensione effettiva della coda di invio per consentire gli invii mentre alcune operazioni sono ancora in corso. È possibile ottenere le dimensioni effettive della coda allocata chiamando GetIoRingInfo.

h

Riceve l'handle HIORING risultante, se la creazione ha avuto esito positivo. L'anello HIORING restituito deve essere chiuso chiamando CloseIoRing, non CloseHandle, per rilasciare le risorse sottostanti per IORING.

Valore restituito

HRESULT, incluso ma non limitato ai seguenti elementi:

Valore Descrizione
S_OK Operazione completata.
IORING_E_UNKNOWN_VERSION La versione specificata in ioringVersion è sconosciuta.

Requisiti

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