struttura NVME_COMPLETION_ENTRY (nvme.h)

Specifica una voce nella coda di completamento con dimensioni pari a 16 byte.

Sintassi

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;

Members

DW0

Il contenuto di Dword 0 contiene informazioni specifiche del comando.

Se un comando usa Dword 0, la definizione di questa Dword è contenuta nella definizione del comando associata. Se un comando non usa Dword 0, questo campo è riservato.

DW1

DW2

Unione che contiene le informazioni in Dword 2.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Indica il puntatore head della coda di invio corrente per la coda di invio indicata nel campo SQ Identifier (SQID). Viene usato per indicare all'host le voci della coda di invio utilizzate e che possono essere riutilizzate per le nuove voci.

Nota

Il valore restituito è il valore del puntatore head della coda di invio quando è stata creata la voce della coda di completamento. Quando il software host ora utilizza la voce della coda di completamento, il controller può avere un puntatore sq Head che ha avanzato oltre il valore indicato.

DW2.DUMMYSTRUCTNAME.SQID

Specifica la coda di invio a cui è stato eseguito il comando associato. Il campo SQID viene usato in combinazione con il CID (Command Identifier) dal software host per determinare in modo univoco il comando completato quando più code di invio condividono una singola coda di completamento.

DW2.AsUlong

DW3

Unione che contiene le informazioni in Dword 3.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

Indica l'identificatore del comando da completare.

Questo identificatore viene assegnato dal software host quando il comando viene inviato alla coda di invio. La combinazione di SQ Identifier SQID e COMMAND Identifier CID identifica in modo univoco il comando che viene completato. Il numero massimo di richieste in attesa contemporaneamente è 64.000.

DW3.DUMMYSTRUCTNAME.Status

Struttura NVME_COMMAND_STATUS che indica lo stato del comando che viene completato.

Il valore di 0h per questo campo indica un completamento del comando riuscito senza condizioni di errore irreversibili o non irreversibili. Se non diversamente specificato, se un comando non viene completato correttamente per più motivi, il codice di stato specifico restituito viene scelto dal fornitore.

DW3.AsUlong

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Intestazione nvme.h