estructura de NVME_COMPLETION_ENTRY (nvme.h)

Especifica una entrada en la cola de finalización que tiene un tamaño de 16 bytes.

Sintaxis

typedef struct {
  ULONG DW0;
  ULONG DW1;
  union {
    struct {
      USHORT SQHD;
      USHORT SQID;
    } DUMMYSTRUCTNAME;
    ULONG AsUlong;
  } DW2;
  union {
    struct {
      USHORT              CID;
      NVME_COMMAND_STATUS Status;
    } DUMMYSTRUCTNAME;
    ULONG AsUlong;
  } DW3;
} NVME_COMPLETION_ENTRY, *PNVME_COMPLETION_ENTRY;

Miembros

DW0

El contenido de Dword 0 contiene información específica del comando.

Si un comando usa Dword 0, la definición de esta Dword se encuentra dentro de la definición de comando asociada. Si un comando no usa Dword 0, este campo está reservado.

DW1

DW2

Unión que contiene la información de Dword 2.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Indica el puntero principal de cola de envío actual para la cola de envío indicada en el campo Identificador SQ (SQID). Esto se usa para indicar al host las entradas de cola de envío que se han consumido y que se pueden volver a usar para las nuevas entradas.

Nota

El valor devuelto es el valor del puntero Principal de cola de envío cuando se creó la entrada de cola de finalización. En el momento en que el software host consume la entrada de cola de finalización, el controlador puede tener un puntero de cabeza SQ que haya avanzado más allá del valor indicado.

DW2.DUMMYSTRUCTNAME.SQID

Especifica la cola de envío a la que se emitió el comando asociado. El campo SQID se usa en combinación con el identificador de comando (CID) por el software host para determinar de forma única el comando completado cuando más de una cola de envío comparte una sola cola de finalización.

DW2.AsUlong

DW3

Unión que contiene la información de Dword 3.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

Indica el identificador del comando que se está completando.

El software host asigna este identificador cuando el comando se envía a la cola de envío. La combinación de SQ Identifier SQID y COMMAND Identifier CID identifica de forma única el comando que se está completando. El número máximo de solicitudes pendientes al mismo tiempo es de 64 000.

DW3.DUMMYSTRUCTNAME.Status

Estructura NVME_COMMAND_STATUS que indica el estado del comando que se está completando.

Un valor de 0h para este campo indica una finalización correcta del comando sin condiciones de error irrecuperables o no irrecuperables. A menos que se indique lo contrario, si un comando no se completa correctamente por varios motivos, el proveedor elige el código de estado determinado devuelto.

DW3.AsUlong

Requisitos

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