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 結構，指出正在完成之命令的狀態。

這個 Field 的 值 0h 表示成功完成命令，且沒有嚴重或非嚴重錯誤狀況。 除非另有說明，否則如果命令因為多個原因而無法順利完成，則廠商會選擇傳回的特定狀態代碼。

DW3.AsUlong

規格需求

需求	值
最低支援的用戶端	Windows 10
標頭	nvme.h