NVME_CDW10_CREATE_IO_QUEUE union (nvme.h)
包含“创建 I/O 完成队列”和“创建 IO 提交队列”命令中使用的参数。 “创建 I/O 完成队列”命令用于创建所有 I/O 完成队列(管理员完成队列除外)和“创建 I/O 提交队列”命令用于创建 I/O 提交队列。
NVME_CDW10_CREATE_IO_QUEUE结构用于命令结构的 CREATEIOCQ 和 CREATEIOSQ 参数的 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 |