Función BuildIoRingReadFile (ioringapi.h)

  • Artículo

Realiza una lectura asincrónica de un archivo mediante un anillo de E/S. Esta operación es similar a llamar a ReadFileEx.

Sintaxis

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

Parámetros

ioRing

Un HIORING que representa un identificador en el anillo de E/S que realizará la operación de lectura.

fileRef

Un IORING_HANDLE_REF especificando el archivo que se va a leer.

dataRef

Un IORING_BUFFER_REF especificando el búfer en el que se lee el archivo. El búfer proporcionado debe tener un tamaño de al menos numberOfBytesToRead bytes.

numberOfBytesToRead

Número de bytes que se va a leer.

fileOffset

Desplazamiento en el archivo que se va a empezar a leer.

userData

Valor de UINT_PTR que identifica la operación de lectura de archivos. Especifique este valor al cancelar la operación con una llamada a BuildIoRingCancelRequest. Si una aplicación implementa el comportamiento de cancelación para la operación, el valor userData debe ser único. De lo contrario, el sistema trata el valor como opaco y puede ser cualquier cosa, incluido 0.

sqeFlags

Valor devuelto

Devuelve un VALOR HRESULT, incluido, pero no limitado a lo siguiente:

Valor Descripción
S_OK Correcto
IORING_E_SUBMISSION_QUEUE_FULL La cola de envío está llena y no hay entradas adicionales disponibles para la compilación. La aplicación debe enviar las entradas existentes y esperar a que algunas de ellas se completen antes de agregar más operaciones a la cola.
IORING_E_UNKNOWN_REQUIRED_FLAG La aplicación proporcionó una marca necesaria que no se conoce para la implementación. El código de biblioteca debe comprobar el campo IoRingVersion del IORING_INFO obtenido de una llamada a GetIoRingInfo para determinar la versión de api de un anillo de E/S que determina las operaciones y las marcas que se admiten. Las aplicaciones deben conocer la versión que usaron para crear el anillo de E/S y, por lo tanto, no deben proporcionar marcas no admitidas en tiempo de ejecución.

Comentarios

Compruebe la compatibilidad del anillo de E/S para las operaciones de lectura de archivos llamando a IsIoRingOpSupported y especificando IORING_OP_READ para el parámetro op .

Requisitos

Requisito Value
Cliente mínimo compatible Compilación 22000 de Windows
Servidor mínimo compatible Compilación 22000 de Windows
Encabezado ioringapi.h