estrutura NVME_COMPLETION_ENTRY (nvme.h)

Especifica uma entrada na Fila de Conclusão que tem 16 bytes de tamanho.

Sintaxe

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;

Membros

DW0

O conteúdo do Dword 0 contém informações específicas do comando.

Se um comando usar Dword 0, a definição desse Dword estará contida na definição de comando associada. Se um comando não usar Dword 0, esse campo será reservado.

DW1

DW2

Uma união que contém as informações em Dword 2.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Indica o ponteiro de Cabeçalho da Fila de Envio atual para a Fila de Envio indicada no campo SQID (Sq Identifier). Isso é usado para indicar ao host as entradas da Fila de Envio que foram consumidas e podem ser reutilizados para novas entradas.

Observação

O valor retornado é o valor do ponteiro Cabeçalho da Fila de Envio quando a entrada da fila de conclusão foi criada. Quando o software host consome a entrada da fila de conclusão, o controlador pode ter um ponteiro do SQ Head que tenha avançado além do valor indicado.

DW2.DUMMYSTRUCTNAME.SQID

Especifica a Fila de Envio à qual o comando associado foi emitido. O campo SQID é usado em combinação com o CID (Identificador de Comando) pelo software host para determinar exclusivamente o comando concluído quando mais de uma Fila de Envio compartilha uma única Fila de Conclusão.

DW2.AsUlong

DW3

Uma união que contém as informações em Dword 3.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

Indica o identificador do comando que está sendo concluído.

Esse identificador é atribuído pelo software host quando o comando é enviado para a Fila de Envio. A combinação do SQID do Identificador SQ e do CID do Identificador de Comando identifica exclusivamente o comando que está sendo concluído. O número máximo de solicitações pendentes ao mesmo tempo é 64K.

DW3.DUMMYSTRUCTNAME.Status

Uma estrutura NVME_COMMAND_STATUS que indica o status para o comando que está sendo concluído.

Um valor de 0h para este Campo indica uma conclusão de comando bem-sucedida sem condições de erro fatais ou não fatais. A menos que indicado de outra forma, se um comando não for concluído com êxito por vários motivos, o código de status específico retornado será escolhido pelo fornecedor.

DW3.AsUlong

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Cabeçalho	nvme.h