NVME_COMMAND_EFFECTS_DATA聯盟 （nvme.h）

包含描述「管理」或「I/O」指令整體可能效果的資訊，包括指令的任何選用功能。

此結構用於NVME_COMMAND_EFFECTS_LOG的ACS和IOCS欄位。

語法

typedef union {
  struct {
    ULONG CSUPP : 1;
    ULONG LBCC : 1;
    ULONG NCC : 1;
    ULONG NIC : 1;
    ULONG CCC : 1;
    ULONG Reserved0 : 11;
    ULONG CSE : 3;
    ULONG Reserved1 : 13;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_COMMAND_EFFECTS_DATA, *PNVME_COMMAND_EFFECTS_DATA;

Members

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.CSUPP

指出是否支援命令。

當此值設定為 1時，控制器會支援命令。 當此值清除為 0時，控制器不支援該命令，且此結構中的所有其他欄位都會清除為 0h。

DUMMYSTRUCTNAME.LBCC

指出指令是否可以修改一或多個命名空間中的邏輯區塊內容。

當此值設為 1時，指令可以修改一或多個命名空間中的邏輯區塊內容。 當清除此值 0為 時，指令不會修改任何名稱空間中的邏輯區塊內容。 邏輯區塊內容變更包括寫入邏輯區塊。

DUMMYSTRUCTNAME.NCC

指出命令是否可以變更單一命名空間的功能。

當此值設為 1時，指令可以變更單一命名空間的功能。 當清除此值 0為 時，指令不會修改指定命名空間的任何命名空間功能。 命名空間功能變更包括邏輯格式變更。

DUMMYSTRUCTNAME.NIC

指出命令是否可以變更多個命名空間的命名空間或功能數目。

當此值設為 1時，指令可以變更多個命名空間的名稱空間或功能數目。 當清除此值 0為 時，指令不會修改多個名稱空間的名稱空間數目或功能。 命名空間詳細目錄變更 （NIC） 包括新增或移除命名空間。

DUMMYSTRUCTNAME.CCC

指出指令是否可以變更控制器功能。

當此值設為 1時，指令可以變更控制器功能。 當清除此值為 0時，指令不會修改控制器功能。 控制器功能變更 （CCC） 包含韌體更新，可變更 CAP 暫存器中報告的功能。

DUMMYSTRUCTNAME.Reserved0

DUMMYSTRUCTNAME.CSE

定義相關聯命令的命令提交和執行建議的 NVME_COMMAND_EFFECT_SBUMISSION_EXECUTION_LIMITS 值。

DUMMYSTRUCTNAME.Reserved1

AsUlong

備註

主機軟體在決定如何提交命令和命令完成後要採取的動作時，可能會考慮命令效果。 如果命令變更特定功能。 主機軟體應該在命令完成之後，重新列舉和/或重新初始化相關聯的功能。

例如，如果可能發生命名空間功能變更，則主機軟體應該暫停相關聯命名空間的使用，提交可能導致命名空間功能變更的命令並等待其完成，然後重新發出識別命令。

需求

另請參閱

• NVME_COMMAND_EFFECTS_LOG