Freigeben über


NVME_CDW10_CREATE_IO_QUEUE Union (nvme.h)

Enthält Parameter, die in den Befehlen "E/A-Vervollständigungswarteschlange erstellen" und "E/A-Übermittlungswarteschlange erstellen" verwendet werden. Der Befehl "E/A-Vervollständigungswarteschlange erstellen" wird verwendet, um alle E/A-Vervollständigungswarteschlangen mit Ausnahme der Administratorabschlusswarteschlange 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 Befehlsstruktur verwendet.

Syntax

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

Elemente

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

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

Dieser Bezeichner entspricht entweder der Abschlusswarteschlangenkopftür, die für den Befehl "Vervollständigungswarteschlange" oder " Übermittlungswarteschlange Tail Doorbell " für den Befehl "Übermittlungswarteschlange" verwendet wird.

Dieser 16-Bit-ID-Wert sollte den im feature NVME_FEATURE_NUMBER_OF_QUEUES für E/A-Vervollständigungswarteschlangen oder E/A-Übermittlungswarteschlangen gemeldeten Wert nicht überschreiten. Wenn der angegebene Wert die 0hgemeldete Anzahl von Warteschlangen überschreitet oder einem bezeichner entspricht, der bereits verwendet wird, sollte der Controller einen Fehler von NVME_STATUS_INVALID_QUEUE_IDENTIFIER zurückgeben.

DUMMYSTRUCTNAME.QSIZE

Das Feld "Warteschlangengröße(QSIZE)" gibt die Größe der zu erstellenden Vervollständigungswarteschlange 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 ist zwei Einträge. Die maximale Größe für eine E/A-Übermittlungswarteschlange oder eine E/A-Vervollständigungswarteschlange beträgt 64K-Einträge, die durch die maximale Warteschlangengröße begrenzt wird, die vom Controller unterstützt wird, der im Feld "Maximale Warteschlangeneinträge unterstützt" (MQES) der NVME_CONTROLLER_CAPABILITIES-Struktur gemeldet wird.

Die maximale Größe für die Administratorübermittlung und die Administratorabschlusswarteschlange ist als 4K-Einträge definiert. Ein Eintrag in jeder Warteschlange ist aufgrund der Head- und Tail-Einstiegspunktdefinition nicht verfügbar.

Wenn die Größe oder größer als 0h der Controller ist, sollte der Controller einen Fehler der ungültigen Warteschlangengröße zurückgeben.

AsUlong

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 10
Header nvme.h

Siehe auch