Compartir a través de


NVME_CDW10_CREATE_IO_QUEUE unión (nvme.h)

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 del administrador 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 .

Syntax

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

Members

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

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

Este identificador corresponde a la puerta principal de cola de finalización que se usa para el comando Cola de finalización o la cola de cola de envío usada 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 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 de NVME_CONTROLLER_CAPABILITIES .

El tamaño máximo de la cola de envío de administrador y finalización de administrador 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

Requirement Importancia
Cliente mínimo compatible Windows 10
Header nvme.h

Consulte también