NVME_COMPLETION_ENTRY Struktur (nvme.h)

Gibt einen Eintrag in der Vervollständigungswarteschlange an, der 16 Byte groß ist.

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;

Elemente

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 kein Befehl Dword 0 verwendet, ist dieses Feld reserviert.

DW1

DW2

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

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Gibt den aktuellen Kopfzeiger der Übermittlungswarteschlange für die Übermittlungswarteschlange an, die im Feld SQID (SQID) angegeben ist. Dies wird verwendet, um dem Host die Übermittlungswarteschlangeneinträge anzugeben, die verbraucht wurden und möglicherweise für neue Einträge erneut verwendet werden.

DW2.DUMMYSTRUCTNAME.SQID

Gibt die Übermittlungswarteschlange an, für 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 mehrere Übermittlungswarteschlange eine einzelne Abschlusswarteschlange gemeinsam nutzen.

DW2.AsUlong

DW3

Eine Vereinigung, 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 der SQ Identifier SQID und der Befehls-ID-CID identifiziert eindeutig den Befehl, der abgeschlossen wird. Die maximale Anzahl der gleichzeitig ausstehenden Anforderungen beträgt 64 KB.

DW3.DUMMYSTRUCTNAME.Status

Eine NVME_COMMAND_STATUS Struktur, die den Status des abgeschlossenen Befehls angibt.

Ein Wert für 0h dieses Feld gibt einen erfolgreichen Befehlsabschluss ohne schwerwiegende oder nicht schwerwiegende Fehlerbedingungen an. Sofern nicht anders angegeben, wird der vom Anbieter zurückgegebene Statuscode ausgewählt, wenn ein Befehl aus mehreren Gründen nicht erfolgreich abgeschlossen werden kann.

DW3.AsUlong

Anforderungen