NVME_CDW10_CREATE_IO_QUEUE Union (nvme.h)

  • Artikel

Enthält Parameter, die in den Befehlen E/A-Abschlusswarteschlange erstellen und E/A-Übermittlungswarteschlange erstellen verwendet werden. Der Befehl E/A-Vervollständigungswarteschlange erstellen wird verwendet, um alle E/A-Abschlusswarteschlangen mit Ausnahme der Admin Abschlusswarteschlange zu erstellen, und der Befehl E/A-Übermittlungswarteschlange erstellen wird verwendet, um E/A-Übermittlungswarteschlangen zu erstellen.

Die NVME_CDW10_CREATE_IO_QUEUE-Struktur wird im CDW10-Feld der Parameter CREATEIOCQ und CREATEIOSQ der Command-Struktur verwendet.

Syntax

typedef union {
  struct {
    ULONG QID : 16;
    ULONG QSIZE : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW10_CREATE_IO_QUEUE, *PNVME_CDW10_CREATE_IO_QUEUE;

Member

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

Das Feld Queue Identifier (QID) gibt den Bezeichner an, der der zu erstellenden Abschluss- oder Übermittlungswarteschlange zugewiesen werden soll.

Dieser Bezeichner entspricht entweder der Abschlusswarteschlangenkopf-Türklingel , die für den Befehl "Abschlusswarteschlange" verwendet wird, oder der für den Befehl " Übermittlungswarteschlange ".

Dieser 16-Bit-ID-Wert sollte den im NVME_FEATURE_NUMBER_OF_QUEUES-Feature für E/A-Abschlusswarteschlangen oder E/A-Übermittlungswarteschlangen angegebenen Wert nicht überschreiten. Wenn der angegebene Wert ist 0h, überschreitet die Anzahl der gemeldeten Warteschlangen oder entspricht einem bereits verwendeten Bezeichner, sollte der Controller den Fehler NVME_STATUS_INVALID_QUEUE_IDENTIFIER zurückgeben.

DUMMYSTRUCTNAME.QSIZE

Das Feld Warteschlangengröße (QSIZE) gibt die Größe der zu erstellenden Abschluss- oder Übermittlungswarteschlange an. Die Warteschlangengröße wird in einem 16-Bit-0-basierten Feld angegeben, das die Anzahl der Einträge in der Warteschlange angibt.

Die Mindestgröße für eine Warteschlange beträgt zwei Einträge. Die maximale Größe für eine E/A-Übermittlungswarteschlange oder eine E/A-Vervollständigungswarteschlange beträgt 64.000 Einträge, begrenzt durch die maximale Warteschlangengröße, die vom Controller unterstützt wird, der im Feld Maximale unterstützte Warteschlangeneinträge (MQES) der NVME_CONTROLLER_CAPABILITIES-Struktur gemeldet wird.

Die maximale Größe für die Admin Übermittlung und Admin Abschlusswarteschlange wird als 4.000 Einträge definiert. Ein Eintrag in jeder Warteschlange ist aufgrund der Definition des Kopf- und Tail-Einstiegszeigers nicht für die Verwendung verfügbar.

Wenn die Größe oder größer ist 0h als vom Controller unterstützt, sollte der Controller den Fehler Ungültige Warteschlangengröße zurückgeben.

AsUlong

Anforderungen

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

Weitere Informationen