unión de NVME_CDW10_CREATE_IO_QUEUE (nvme.h)

  • Artículo

Contiene parámetros que se usan en los comandos Crear cola de finalización de E/S y Crear cola de envío de E/S. El comando Crear cola de finalización de E/S se usa para crear todas las colas de finalización de E/S con la excepción de la cola de finalización de Administración y el comando Crear cola de envío de E/S se usa para crear colas de envío de E/S.

La estructura NVME_CDW10_CREATE_IO_QUEUE se usa en el campo CDW10 de los parámetros CREATEIOCQ y CREATEIOSQ de la estructura Command .

Sintaxis

typedef union {
  struct {
    ULONG QID : 16;
    ULONG QSIZE : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW10_CREATE_IO_QUEUE, *PNVME_CDW10_CREATE_IO_QUEUE;

Miembros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

El campo Identificador de cola (QID) indica el identificador que se va a asignar a la cola de finalización o a la cola de envío que se va a crear.

Este identificador corresponde al timbre principal de la cola de finalización que se usa para el comando Cola de finalización o a la cola de envío que se usa para el comando Cola de envío.

Este valor de identificador de 16 bits no debe superar el valor notificado en la característica de NVME_FEATURE_NUMBER_OF_QUEUES para colas de finalización de E/S o colas de envío de E/S. Si el valor especificado es 0h, supera el número de colas notificadas o corresponde a un identificador que ya está en uso, el controlador debe devolver un error de NVME_STATUS_INVALID_QUEUE_IDENTIFIER.

DUMMYSTRUCTNAME.QSIZE

El campo Tamaño de cola (QSIZE) indica el tamaño de la cola de finalización o cola de envío que se va a crear. El tamaño de la cola se indica en un campo basado en 16 bits de 0 que especifica el número de entradas de la cola.

El tamaño mínimo de una cola es de dos entradas. El tamaño máximo de una cola de envío de E/S o una cola de finalización de E/S es de 64 000 entradas, limitadas por el tamaño máximo de cola admitido por el controlador que se notifica en el campo Número máximo de entradas de cola admitidas (MQES) de la estructura NVME_CONTROLLER_CAPABILITIES .

El tamaño máximo del envío de Administración y la cola de finalización de Administración se define como entradas 4K. Una entrada de cada cola no está disponible para su uso debido a la definición del puntero de entrada Head y Tail.

Si el tamaño es 0h o mayor que el controlador admite, el controlador debe devolver un error de Tamaño de cola no válido.

AsUlong

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Encabezado nvme.h

Consulte también