NVME_COMPLETION_QUEUE_HEAD_DOORBELL Union (nvme.h)

Definiert das Türklingelregister, das den Head-Einstiegszeiger für Die Vervollständigungswarteschlange y aktualisiert.

Der Wert von y entspricht dem Warteschlangenbezeichner, dem 16-Bit-ID-Wert, der der Warteschlange beim Erstellen zugewiesen wird. Dieser Wert gibt Vervollständigungswarteschlangeneinträge an, die von Hostsoftware verarbeitet wurden.

Der Offset der Vervollständigungswarteschlange y Head Doorbell (CQyHDBL) lautet: (1000h + ((2y + 1) * (4 << CAP.DSTRD)))

Wobei CAP.DSTRD ist der Wert des DSTRD-Felds in NVME_CONTROLLER_CAPABILITIES.

Syntax

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

Member

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.CQH

Ein Lese-/Schreibfeld, das den neuen Wert des Einstiegszeigers der Vervollständigungswarteschlange angibt.

Dieser Wert überschreibt alle zuvor bereitgestellten CQH-Werte (Completion Queue Head). Der Unterschied zwischen dem letzten CQH-Schreibvorgang und dem aktuellen CQH-Einstiegszeigerschreiben gibt die Anzahl der Einträge an, die jetzt für die Wiederverwendung durch den Controller in der Vervollständigungswarteschlange verfügbar sind.

Hinweis

Der Vervollständigungswarteschlangenrollover muss berücksichtigt werden.

DUMMYSTRUCTNAME.Reserved0

Ein schreibgeschütztes reserviertes Feld.

AsUlong

Hinweise

Der Host sollte die Klingelregister nicht lesen. Wenn ein Klingelregister gelesen wird, ist der zurückgegebene Wert herstellerspezifisch. Das Schreiben in eine nicht vorhandene Vervollständigungswarteschlangenkopf-Türklingel hat nicht definierte Ergebnisse.

Hostsoftware sollte die Vervollständigungswarteschlangeneinträge in Vervollständigungswarteschlangen weiterhin verarbeiten, unabhängig davon, ob einträge in einer Übermittlungswarteschlange verfügbar sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Kopfzeile	nvme.h