NVME_CDW10_CREATE_IO_QUEUE Union (nvme.h)
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 |