Compartir a través de

Función BuildIoRingReadFile (ioringapi.h)

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

Syntax

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

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 especificar 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 van a leer.

fileOffset

Desplazamiento en el archivo que se va a comenzar 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:

Importancia Description
S_OK Success
IORING_E_SUBMISSION_QUEUE_FULL La cola de envío está llena y no hay entradas adicionales disponibles para compilar. La aplicación debe enviar las entradas existentes y esperar a que algunos de ellos 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.

Observaciones

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

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows Build 22000
Servidor mínimo admitido Windows Build 22000
Header ioringapi.h
Library kernel32. Lib
  • Last updated on