NVME_COMPLETION_ENTRY-Struktur (nvme.h)

Gibt einen Eintrag in der Vervollständigungswarteschlange mit einer Größe von 16 Bytes an.

Syntax

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;

Member

DW0

Der Inhalt von Dword 0 enthält befehlsspezifische Informationen.

Wenn ein Befehl Dword 0 verwendet, ist die Definition dieses Dwords in der zugehörigen Befehlsdefinition enthalten. Wenn ein Befehl Dword 0 nicht verwendet, ist dieses Feld reserviert.

DW1

DW2

Eine Union, die die Informationen in Dword 2 enthält.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Gibt den aktuellen Zeiger der Übermittlungswarteschlange für die Übermittlungswarteschlange an, die im Feld SQ-Bezeichner (SQID) angegeben ist. Dies wird verwendet, um dem Host die Einträge in der Übermittlungswarteschlange anzugeben, die verbraucht wurden und für neue Einträge erneut verwendet werden können.

Hinweis

Der zurückgegebene Wert ist der Wert des Übermittlungswarteschlangenkopfzeigers beim Erstellen des Vervollständigungswarteschlangeneintrags. Wenn die Hostsoftware den Vervollständigungswarteschlangeneintrag nutzt, verfügt der Controller möglicherweise über einen SQ Head-Zeiger, der über den angegebenen Wert hinaus fortgeschritten ist.

DW2.DUMMYSTRUCTNAME.SQID

Gibt die Übermittlungswarteschlange an, an die der zugeordnete Befehl ausgegeben wurde. Das SQID-Feld wird in Kombination mit dem Befehlsbezeichner (Command Identifier, CID) von der Hostsoftware verwendet, um den abgeschlossenen Befehl eindeutig zu bestimmen, wenn mehr als eine Übermittlungswarteschlange eine einzelne Vervollständigungswarteschlange gemeinsam hat.

DW2.AsUlong

DW3

Eine Union, die die Informationen in Dword 3 enthält.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

Gibt den Bezeichner des Befehls an, der abgeschlossen wird.

Dieser Bezeichner wird von der Hostsoftware zugewiesen, wenn der Befehl an die Übermittlungswarteschlange übermittelt wird. Die Kombination aus SQ Identifier SQID und Command Identifier CID identifiziert eindeutig den befehl, der abgeschlossen wird. Die maximale Anzahl der gleichzeitig ausstehenden Anforderungen beträgt 64.000.

DW3.DUMMYSTRUCTNAME.Status

Eine NVME_COMMAND_STATUS-Struktur, die die status für den abgeschlossenen Befehl angibt.

Der Wert von 0h für dieses Feld gibt eine erfolgreiche Befehlsvervollständigung ohne schwerwiegende oder nicht schwerwiegende Fehlerbedingungen an. Wenn ein Befehl aus mehreren Gründen nicht erfolgreich abgeschlossen werden kann, wird der zurückgegebene status Code vom Anbieter ausgewählt, sofern nicht anders angegeben.

DW3.AsUlong

Anforderungen

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