NVME_CDW11_CREATE_IO_SQ Union (nvme.h)

  • Artikel

Enthält Parameter für den Befehl E/A-Übermittlungswarteschlange erstellen, der zum Erstellen von E/A-Übermittlungswarteschlangen verwendet wird.

Die NVME_CDW11_CREATE_IO_SQ-Struktur wird im CDW11-Feld des CREATEIOSQ-Parameters der Command-Struktur verwendet.

Syntax

typedef union {
  struct {
    ULONG PC : 1;
    ULONG QPRIO : 2;
    ULONG Reserved0 : 13;
    ULONG CQID : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW11_CREATE_IO_SQ, *PNVME_CDW11_CREATE_IO_SQ;

Member

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.PC

Das Feld Physically Contiguous (PC) gibt an, ob die Übermittlungswarteschlange physisch im Arbeitsspeicher zusammenhängend ist.

Wenn dieser Wert auf 1festgelegt ist, ist die Übermittlungswarteschlange physisch zusammenhängend, und PRP-Eintrag 1 (PRP1 in der Befehlsdatenstruktur) ist die Adresse eines zusammenhängenden physischen Puffers. Wenn der Wert auf 0festgelegt ist, ist die Übermittlungswarteschlange nicht physisch zusammenhängend, und PRP1 ist ein PRP-Listenzeiger.

Wenn dieser Wert auf 0 gelöscht wird und das Feld Zusammenhängende Warteschlangen erforderlich (CQR) in Controllerfunktionen auf 1 festgelegt ist, sollte der Controller eine status NVME_STATUS_INVALID_FIELD_IN_COMMAND zurückgeben.

Wenn sich die Warteschlange im Controllerspeicherpuffer befindet und der PC auf 0deaktiviert ist, schlägt der Controller den Befehl mit einer status NVME_STATUS_INVALID_USE_OF_CONTROLLER_MEMORY_BUFFER fehl.

DUMMYSTRUCTNAME.QPRIO

Das Feld Warteschlangenpriorität (Queue Priority, QPRIO) gibt die Prioritätsklasse an, die für Befehle in dieser Übermittlungswarteschlange verwendet werden soll, indem ein NVME_NVM_QUEUE_PRIORITIES Enumerationswert angegeben wird.

Dieses Feld wird nur verwendet, wenn der gewichtete Roundrobin mit der Prioritätsklasse "Dringend" der ausgewählte Schiedsmechanismus ist. Das Feld wird ignoriert, wenn das gewichtete Roundrobin mit der Prioritätsklasse "Dringend" nicht verwendet wird.

DUMMYSTRUCTNAME.Reserved0

DUMMYSTRUCTNAME.CQID

Das Feld Warteschlangenbezeichner (QUEUE Identifier, QID) gibt den Bezeichner der Abschlusswarteschlange an, die für alle Der Übermittlungswarteschlange zugeordneten Befehlsabschlusseinträge verwendet werden soll.

Der Wert von 0h (Admin Abschlusswarteschlange) sollte nicht angegeben werden.

Wenn der angegebene Wert einer gültigen E/A-Abschlusswarteschlange entspricht 0h oder nicht, sollte der Controller den Fehler NVME_STATUS_INVALID_QUEUE_IDENTIFIER zurückgeben.

AsUlong

Anforderungen

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

Weitere Informationen