NVME_CDW10_FORMAT_NVM 共用体 (nvme.h)

NVM メディアの低レベルの書式設定に使用される [NVM の書式設定] コマンドのパラメーターが含まれています。

このコマンドは、ホストが論理ブロック アドレス (LBA) のデータ サイズやメタデータ サイズを変更する場合に使用されます。 低レベルの形式では、すべての名前空間に関連付けられているすべてのデータとメタデータ、またはコマンドに関連付けられている特定の名前空間のみが破棄される可能性があります (コントローラーの識別データ構造の省略可能な管理 コマンド サポート (OACS) フィールドの NVM 属性の形式を参照してください)。 FORMAT 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

NVM メディアに適用する LBA 形式を指定する NVME_LBA_FORMAT 値。 サポートされている LBA 形式のみを選択できます。 この値は、Identify コマンドのNVME_IDENTIFY_NAMESPACE_DATA構造の LBAF フィールドに対応します。

DUMMYSTRUCTNAME.MS

メタデータ設定を指定します。

メタデータが拡張データ LBA の一部として転送される場合、このフィールドが に 1 設定されている場合。 メタデータが別のバッファーの一部として転送される場合、このフィールドは にクリア 0 されます。 メタデータには、保護情報 (PI) フィールドに基づく保護情報が含まれる場合があります。 選択した LBA 形式の [メタデータ サイズ MS] フィールドが の0h場合、このフィールドは適用されません。

DUMMYSTRUCTNAME.PI

エンド ツー エンドのデータ保護を有効にするかどうか、および保護情報の種類を指定するNVME_PROTECTION_INFORMATION_TYPES列挙値。

DUMMYSTRUCTNAME.PIL

保護情報の場所を指定します。

この値が に 1 設定され、保護情報が有効になっている場合、保護情報はメタデータの最初の 8 バイトとして転送されます。 に 0 クリアされ、保護情報が有効になっている場合、保護情報はメタデータの最後の 8 バイトとして転送されます。 この設定は、名前空間の識別データ構造の [書式設定された LBA サイズ LBAF] フィールドで報告されます。

DUMMYSTRUCTNAME.SES

セキュリティで保護された消去を形式とセキュリティで保護された消去操作の種類の一部として実行するかどうかを指定する NVME_SECURE_ERASE_SETTINGS列挙値 。 消去は、場所に関係なく、すべてのユーザー データに適用されます。 たとえば、公開されている LBA 内、キャッシュ内、または割り当て解除された LBA 内などです。

DUMMYSTRUCTNAME.ZF

DUMMYSTRUCTNAME.Reserved

AsUlong

要件

こちらもご覧ください

• NVME_IDENTIFY_NAMESPACE_DATA
• NVME_LBA_FORMAT