NVME_COMPLETION_ENTRY 结构 (nvme.h)

指定完成队列中大小为 16 字节的条目。

语法

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;

成员

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

要求

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