NVME_COMMAND_STATUS union （nvme.h）

包含有关命令状态的信息。

此结构用于NVME_COMPLETION_ENTRY的“状态”字段和NVME_ERROR_INFO_LOG的“状态”字段中，以指示已完成的命令的状态。

Syntax

typedef union {
  struct {
    USHORT P : 1;
    USHORT SC : 8;
    USHORT SCT : 3;
    USHORT Reserved : 2;
    USHORT M : 1;
    USHORT DNR : 1;
  } DUMMYSTRUCTNAME;
  USHORT AsUshort;
} NVME_COMMAND_STATUS, *PNVME_COMMAND_STATUS;

Members

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.P

指示完成队列条目是否为新条目。

所有完成队列条目的阶段标记 （P） 值应在将NVME_CONTROLLER_CONFIGURATION1的 EN 字段设置为之前由主机软件初始化为“0”。

当控制器在完成队列中放置条目时，它将反转阶段标记，使主机软件能够标识新条目。 具体而言，对于 EN 设置为 1后的第一组完成队列条目，所有阶段标记都设置为 1 发布它们时。 对于第二组完成队列条目，当控制器已包装到完成队列顶部时，所有阶段标记都会在发布时清除 0 。 阶段标记的值在每次通过完成队列时反转。

DUMMYSTRUCTNAME.SC

指示标识命令的任何错误或状态信息的状态代码。

DUMMYSTRUCTNAME.SCT

指示控制器返回的状态类型的 NVME_STATUS_TYPES 值。

DUMMYSTRUCTNAME.Reserved

DUMMYSTRUCTNAME.M

指示命令是否有其他状态信息。

如果此值设置为 1，则此命令的状态信息将作为“错误 信息”日志 的一部分，可以使用“获取日志页”命令进行检索。

清除此值 0后，此命令没有其他状态信息。

DUMMYSTRUCTNAME.DNR

指示命令是否成功（如果重新提交）。

如果此值设置为 1，则表示如果重新提交同一命令，则预期会失败。

清除 0此值后，指示重试时，同一命令可能会成功。

如果由于时间有限的错误恢复而中止命令，则应清除 0此字段。 如果清除 SCT 和 SC 字段 0h ，则应清除 0此字段。

AsUshort

要求

另请参阅

• NVME_COMPLETION_ENTRY
• NVME_ERROR_INFO_LOG