NVME_CDW10_CREATE_IO_QUEUE union (nvme.h)

包含“创建 I/O 完成队列”和“创建 IO 提交队列”命令中使用的参数。 “创建 I/O 完成队列”命令用于创建所有 I/O 完成队列(管理员完成队列除外)和“创建 I/O 提交队列”命令用于创建 I/O 提交队列。

NVME_CDW10_CREATE_IO_QUEUE结构用于命令结构的 CREATEIOCQCREATEIOSQ 参数的 CDW10 字段。

语法

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

成员

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

“队列标识符 (QID) ”字段指示要分配给要创建的完成队列或提交队列的标识符。

此标识符对应于用于 完成队列命令的完成队列头门铃 或用于 提交队列命令的提交队列尾门铃

此 16 位 ID 值不应超过 I/O 完成队列或 I/O 提交队列 NVME_FEATURE_NUMBER_OF_QUEUES 功能中报告的值。 如果指定的 0h值为 ,超出报告的队列数,或对应于已使用的标识符,则控制器应返回 错误NVME_STATUS_INVALID_QUEUE_IDENTIFIER

DUMMYSTRUCTNAME.QSIZE

“队列大小 (QSIZE) 字段指示要创建的完成队列或提交队列的大小。 队列大小在基于 16 位 0 的字段中指示,该字段指定队列中的条目数。

队列的最小大小为两个条目。 I/O 提交队列或 I/O 完成队列的最大大小为 64K 条目,受NVME_CONTROLLER_CAPABILITIES 结构的“支持的最大队列条目数 (MQES) 字段中报告的控制器支持的最大队列大小限制。

管理员提交和管理员完成队列的最大大小定义为 4K 条目。 由于头和尾项指针定义,每个队列中的一个条目不可用。

如果大小为 0h 或大于控制器支持的大小,则控制器应返回错误 “队列大小无效”。

AsUlong

要求

要求
最低受支持的客户端 Windows 10
标头 nvme.h

另请参阅