指定完成队列中大小为 16 字节的条目。
Syntax
typedef struct {
ULONG DW0;
ULONG DW1;
union {
struct {
USHORT SQHD;
USHORT SQID;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} DW2;
union {
struct {
USHORT CID;
NVME_COMMAND_STATUS Status;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} DW3;
} NVME_COMPLETION_ENTRY, *PNVME_COMPLETION_ENTRY;
Members
DW0
Dword 0 的内容包含特定于命令的信息。
如果命令使用 Dword 0,则此 Dword 的定义包含在关联的命令定义中。 如果命令不使用 Dword 0,则保留此字段。
DW1
DW2
包含 Dword 2 中信息的联合。
DW2.DUMMYSTRUCTNAME
DW2.DUMMYSTRUCTNAME.SQHD
指示 SQ 标识符 (SQID) 字段中指示的提交队列的当前提交队列头指针。 这用于向主机指示已使用并可能重新用于新条目的提交队列条目。
注释
返回的值是在创建完成队列条目时提交队列头指针的值。 当主机软件使用完成队列条目时,控制器可能具有超出所指示值的 SQ Head 指针。
DW2.DUMMYSTRUCTNAME.SQID
指定向其发出关联命令的提交队列。 当多个提交队列共享单个完成队列时,主机软件将 SQID 字段与命令标识符(CID)结合使用,以唯一地确定已完成的命令。
DW2.AsUlong
DW3
包含 Dword 3 中信息的联合。
DW3.DUMMYSTRUCTNAME
DW3.DUMMYSTRUCTNAME.CID
指示正在完成的命令的标识符。
当命令提交到提交队列时,主机软件会分配此标识符。 SQ 标识符 SQID 和命令标识符 CID 的组合唯一标识正在完成的命令。 一次未完成的请求数上限为 64K。
DW3.DUMMYSTRUCTNAME.Status
一个NVME_COMMAND_STATUS结构,指示正在完成的命令的状态。
此字段的值 0h 表示命令成功完成,且没有致命或非致命错误条件。 除非另有说明,否则如果命令由于多种原因而无法成功完成,则供应商会选择返回的特定状态代码。
DW3.AsUlong
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 10操作系统 |
| Header | nvme.h |