包含用于创建 IO 提交队列的“创建 IO 提交队列”命令的参数。
NVME_CDW11_CREATE_IO_SQ结构用于命令结构的 CREATEIOSQ 参数的 CDW11 字段中。
Syntax
typedef union {
struct {
ULONG PC : 1;
ULONG QPRIO : 2;
ULONG Reserved0 : 13;
ULONG CQID : 16;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} NVME_CDW11_CREATE_IO_SQ, *PNVME_CDW11_CREATE_IO_SQ;
Members
DUMMYSTRUCTNAME
DUMMYSTRUCTNAME.PC
“物理连续”(PC)字段指示提交队列在内存中是否物理连续。
如果此值设置为1,则提交队列在物理上是连续的,PRP 条目 1(命令数据结构中的 PRP1)是连续物理缓冲区的地址。 如果该值设置为 0,则提交队列不是物理连续的, PRP1 是 PRP 列表指针。
如果清除0此值,并且控制器功能中将1“必需队列”(CQR)字段设置为“控制器功能”,则控制器应返回NVME_STATUS_INVALID_FIELD_IN_COMMAND状态。
如果队列位于控制器内存缓冲区中, 并且电脑 已 0清除,则控制器将失败,且状态 为NVME_STATUS_INVALID_USE_OF_CONTROLLER_MEMORY_BUFFER。
DUMMYSTRUCTNAME.QPRIO
“队列优先级”(QPRIO)字段通过指定 NVME_NVM_QUEUE_PRIORITIES 枚举值,指示用于此提交队列中的命令的优先级类。
仅当选择了具有紧急优先级类的加权轮循机制时,才会使用此字段,如果未使用具有紧急优先级类的加权轮循机制,则忽略该字段。
DUMMYSTRUCTNAME.Reserved0
DUMMYSTRUCTNAME.CQID
“队列标识符”(QID)字段指示要用于与此提交队列关联的任何命令完成项的完成队列的标识符。
不应指定(管理员完成队列)的值 0h 。
如果指定的值与 0h 有效的 I/O 完成队列不对应,控制器应返回 NVME_STATUS_INVALID_QUEUE_IDENTIFIER错误。
AsUlong
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 10操作系统 |
| Header | nvme.h |