NVME_COMPLETION_ENTRY structure (nvme.h)

Spécifie une entrée de la file d’attente d’achèvement d’une taille de 16 octets.

Syntaxe

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;

Membres

DW0

Le contenu de Dword 0 contient des informations spécifiques à la commande.

Si une commande utilise Dword 0, la définition de ce Dword est contenue dans la définition de commande associée. Si une commande n’utilise pas Dword 0, ce champ est réservé.

DW1

DW2

Union qui contient les informations dans Dword 2.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Indique le pointeur de tête de file d’attente de soumission actuel pour la file d’attente de soumission indiquée dans le champ SQ Identifier (SQID). Il est utilisé pour indiquer à l’hôte les entrées de file d’attente de soumission qui ont été consommées et qui peuvent être réutilisées pour les nouvelles entrées.

Notes

La valeur retournée est la valeur du pointeur tête de file d’attente de soumission lors de la création de l’entrée de file d’attente d’achèvement. Au moment où le logiciel hôte consomme l’entrée de file d’attente d’achèvement, le contrôleur peut avoir un pointeur SQ Head qui a avancé au-delà de la valeur indiquée.

DW2.DUMMYSTRUCTNAME.SQID

Spécifie la file d’attente de soumission à laquelle la commande associée a été émise. Le champ SQID est utilisé en combinaison avec l’identificateur de commande (CID) par le logiciel hôte pour déterminer de manière unique la commande terminée lorsque plusieurs files d’attente de soumission partagent une file d’attente d’achèvement unique.

DW2.AsUlong

DW3

Union qui contient les informations dans Dword 3.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

Indique l’identificateur de la commande en cours d’exécution.

Cet identificateur est attribué par le logiciel hôte lorsque la commande est envoyée à la file d’attente de soumission. La combinaison du SQ Identifier SQID et du CID d’identificateur de commande identifie de manière unique la commande en cours d’exécution. Le nombre maximal de demandes en attente à la fois est de 64 Ko.

DW3.DUMMYSTRUCTNAME.Status

Structure NVME_COMMAND_STATUS qui indique la status de la commande en cours d’exécution.

La valeur de 0h pour ce champ indique une exécution de commande réussie sans conditions d’erreur irrécupérables ou non irrécupérables. Sauf indication contraire, si une commande ne parvient pas à s’exécuter correctement pour plusieurs raisons, le code status particulier retourné est choisi par le fournisseur.

DW3.AsUlong

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
En-tête	nvme.h