union NVME_COMPLETION_QUEUE_HEAD_DOORBELL (nvme.h)

Définit le registre de sonnette qui met à jour le pointeur d’entrée Head pour La file d’attente d’achèvement y.

La valeur y est équivalente à l’identificateur de file d’attente, valeur d’ID 16 bits affectée à la file d’attente lors de sa création. Cette valeur indique les entrées de file d’attente d’achèvement qui ont été traitées par le logiciel hôte.

Le décalage de la file d’attente d’achèvement y Head Doorbell (CQyHDBL) est le suivant : (1000h + ((2y + 1) * (4 << CAP.DSTRD)))

Où CAP.DSTRD est la valeur du champ DSTRD dans NVME_CONTROLLER_CAPABILITIES.

Syntaxe

typedef union {
  struct {
    ULONG CQH : 16;
    ULONG Reserved0 : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_COMPLETION_QUEUE_HEAD_DOORBELL, *PNVME_COMPLETION_QUEUE_HEAD_DOORBELL;

Membres

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.CQH

Champ En lecture/écriture qui indique la nouvelle valeur du pointeur d’entrée de tête de file d’attente d’achèvement.

Cette valeur remplace toute valeur de tête de file d’attente d’achèvement (CQH) précédemment fournie. La différence entre la dernière écriture CQH et l’écriture du pointeur d’entrée CQH actuelle indique le nombre d’entrées qui sont désormais disponibles pour la réutilisation par le contrôleur dans la file d’attente d’achèvement.

Notes

La substitution de la file d’attente d’achèvement doit être prise en compte.

DUMMYSTRUCTNAME.Reserved0

Champ réservé en lecture seule.

AsUlong

Remarques

L’hôte ne doit pas lire les registres de sonnette. Si un registre de sonnette est lu, la valeur retournée est spécifique au fournisseur. L’écriture dans une sonnette de tête de file d’attente d’achèvement inexistante a des résultats non définis.

Le logiciel hôte doit continuer à traiter les entrées de file d’attente d’achèvement dans les files d’attente d’achèvement, qu’il y ait ou non des entrées disponibles dans une file d’attente de soumission.

Configuration requise

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