Funzione BuildIoRingReadFile (ioringapi.h)

Articolo
08/24/2023

Esegue una lettura asincrona da un file usando un anello di I/O. Questa operazione è simile alla chiamata di ReadFileEx.

Sintassi

HRESULT BuildIoRingReadFile(
  HIORING           ioRing,
  IORING_HANDLE_REF fileRef,
  IORING_BUFFER_REF dataRef,
  UINT32            numberOfBytesToRead,
  UINT64            fileOffset,
  UINT_PTR          userData,
  IORING_SQE_FLAGS  sqeFlags
);

Parametri

ioRing

Hioring che rappresenta un handle all'anello di I/O che eseguirà l'operazione di lettura.

fileRef

IORING_HANDLE_REF specificare il file da leggere.

dataRef

IORING_BUFFER_REF specificare il buffer in cui è letto il file. Il buffer fornito deve avere una dimensione di almeno numeroOfBytesToRead byte.

numberOfBytesToRead

Numero di byte da leggere.

fileOffset

Offset nel file per iniziare la lettura.

userData

Valore UINT_PTR che identifica l'operazione di lettura del file. Specificare questo valore quando si annulla l'operazione con una chiamata a BuildIoRingCancelRequest. Se un'app implementa il comportamento di annullamento per l'operazione, il valore userData deve essere univoco. In caso contrario, il valore viene considerato opaco dal sistema e può essere qualsiasi elemento, incluso 0.

sqeFlags

Valore restituito

Restituisce un valore HRESULT incluso, ma non limitato ai seguenti:

Valore	Descrizione
S_OK	Operazione riuscita
IORING_E_SUBMISSION_QUEUE_FULL	La coda di invio è completa e non sono disponibili voci aggiuntive per la compilazione. L'applicazione deve inviare le voci esistenti e attendere il completamento di alcune di esse prima di aggiungere altre operazioni alla coda.
IORING_E_UNKNOWN_REQUIRED_FLAG	L'applicazione ha fornito un flag obbligatorio che non è noto all'implementazione. Il codice della libreria deve controllare il campo IoRingVersion del IORING_INFO ottenuto da una chiamata a GetIoRingInfo per determinare la versione API di un anello di I/O che determina le operazioni e i flag supportati. Le applicazioni devono conoscere la versione usata per creare l'anello di I/O e pertanto non devono fornire flag non supportati in fase di esecuzione.

Commenti

Controllare il supporto dell'anello di I/O per le operazioni di lettura dei file chiamando IsIoRingOpSupported e specificando IORING_OP_READ per il parametro op .

Requisiti

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

Condividi tramite