NVME_CDW10_FORMAT_NVM union (nvme.h)

包含用於 NVM 媒體低階格式之 FORMAT NVM 命令的參數。

當主機想要變更邏輯區塊位址 (LBA) 數據大小和/或元數據大小時，就會使用此命令。 低階格式可能會終結與所有命名空間相關聯的所有數據和元數據，或只終結與命令相關聯的特定命名空間， (參考 [選擇性 管理員 命令支援] (OACS) 欄位中的 [識別控制器] 資料結構) 中的 [格式化 NVM 屬性]。 格式 NVM 命令成功完成之後，控制器將不會傳回先前包含在受影響命名空間中的任何用戶數據。

Format NVM 命令會在 Command 結構的FORMATNVM 參數中使用 Command Dword 10 CDW10 字段。 所有其他命令特定欄位都會保留。

語法

typedef union {
  struct {
    ULONG LBAF : 4;
    ULONG MS : 1;
    ULONG PI : 3;
    ULONG PIL : 1;
    ULONG SES : 3;
    ULONG ZF : 2;
    ULONG Reserved : 18;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW10_FORMAT_NVM, *PNVME_CDW10_FORMAT_NVM;

成員

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.LBAF

NVME_LBA_FORMAT值，指定要套用至 NVM 媒體的 LBA 格式。 只能選取支援的 LBA 格式。 這個值會對應至 [識別] 命令NVME_IDENTIFY_NAMESPACE_DATA結構中的 LBAF 字段。

DUMMYSTRUCTNAME.MS

指定元數據設定。

如果元數據在延伸數據 LBA 中傳輸元數據，則此欄位設定 1 為 時。 如果元數據在個別緩衝區中傳輸，則會清除 0 此欄位。 元數據可能包含保護資訊，根據 [保護資訊 (PI) ] 字段。 如果選取 LBA 格式的 [元數據大小 MS] 欄位為 0h，則此字段不適用。

DUMMYSTRUCTNAME.PI

NVME_PROTECTION_INFORMATION_TYPES列舉值，指定是否啟用端對端數據保護，以及保護信息的類型。

DUMMYSTRUCTNAME.PIL

指定保護資訊位置。

如果此值設定為 1 ，且保護資訊已啟用，則會將保護資訊傳輸為元數據的前八個字節。 如果清除 0 並啟用保護資訊，則會將保護資訊傳輸為元數據的最後八個字節。 此設定會在 [識別命名空間數據結構] 的 [格式化 LBA 大小 LBAF] 字段中報告。

DUMMYSTRUCTNAME.SES

NVME_SECURE_ERASE_SETTINGS列舉值，指定是否應該將安全清除執行為格式的一部分，以及安全清除作業的類型。 不論位置為何，清除都會套用至所有用戶數據。 例如，在公開的 LBA、快取內，或在已解除分配的 LBA 內。

DUMMYSTRUCTNAME.ZF

DUMMYSTRUCTNAME.Reserved

AsUlong

規格需求

另請參閱

• NVME_IDENTIFY_NAMESPACE_DATA
• NVME_LBA_FORMAT