Edit

Share via

IORING_OP_CODE enumeration (ntioring_x.h)

  • Article

Specifies the type of an I/O ring operation.

Syntax

typedef enum IORING_OP_CODE {
  IORING_OP_NOP,
  IORING_OP_READ,
  IORING_OP_REGISTER_FILES,
  IORING_OP_REGISTER_BUFFERS,
  IORING_OP_CANCEL,
  IORING_OP_WRITE,
  IORING_OP_FLUSH,
  IORING_OP_READ_SCATTER,
  IORING_OP_WRITE_GATHER
} ;

Constants

 
IORING_OP_NOP
No operation. This value is provided to enable testing queue management and overhead performance./
IORING_OP_READ
Read from a file to a buffer.
IORING_OP_REGISTER_FILES
Register an array of file handles with the I/O ring.

If any existing registration exists, it is completely replaced by the registration for this opcode. Any entries in the array with INVALID_HANDLE_VALUE are sparse entries and are not used, which can be used to release one or more of the previously registered files.

Unregistration of all current files is accomplished by providing a zero length array. The input array must remain valid until the operation completes. The change impacts all entries in the queue after this completes. I.e. This implicitly has "link" semantics in that any subsequent entry will not start until after this is completed.
IORING_OP_REGISTER_BUFFERS
Register an array of IORING_BUFFER_INFO with the IORING.

If any existing registration exists, it is completely replaced by the registration for this opcode. Any entries in the array with INVALID_HANDLE_VALUE are sparse entries and are not used, which can be used to release one or more of the previously registered files.

Unregistration of all current files is accomplished by providing a zero length array. The input array must remain valid until the operation completes. The change impacts all entries in the queue after this completes. I.e. This implicitly has "link" semantics in that any subsequent entry will not start until after this is completed.
IORING_OP_CANCEL
Request cancellation of a previously submitted operation. The UserData passed in when the operation was initiated is used to identify the operation to be cancelled. The cancellation operation completes after the canceled operation completes unless there is an error attempting the cancellation. For example, if no operation is found with the specified UserData.

Requirements

Requirement Value
Minimum supported client Windows Build 22000
Minimum supported server Windows Build 22000
Header ntioring_x.h