NVME_CDW10_FORMAT_NVM Union (nvme.h)

Enthält Parameter für den Befehl "NVM formatieren", der zum Formatieren der NVM-Medien auf niedriger Ebene verwendet wird.

Dieser Befehl wird verwendet, wenn der Host die Größe der LBA-Daten (Logical Block Address) und/oder die Metadatengröße ändern möchte. Ein Format auf niedriger Ebene kann alle Daten und Metadaten zerstören, die allen Namespaces zugeordnet sind, oder nur den spezifischen Namespace, der dem Befehl zugeordnet ist (verweisen Sie auf die Format NVM-Attribute im Feld "Optional Admin Command Support (OACS)" der Datenstruktur " Controller identifizieren". Nachdem der BEFEHL "NVM formatieren" erfolgreich abgeschlossen wurde, gibt der Controller keine Benutzerdaten zurück, die zuvor in einem betroffenen Namespace enthalten waren.

Der Befehl "NVM formatieren" verwendet das Befehl Dword 10 CDW10-Feld im PARAMETER FORMATNVM der Befehlsstruktur . Alle anderen Befehlsspezifischen Felder sind reserviert.

Syntax

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;

Elemente

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.LBAF

Ein NVME_LBA_FORMAT Wert, der das LBA-Format angibt, das auf die NVM-Medien angewendet werden soll. Es können nur unterstützte LBA-Formate ausgewählt werden. Dieser Wert entspricht dem LBAF-Feld in der NVME_IDENTIFY_NAMESPACE_DATA Struktur für den Befehl "Identifizieren".

DUMMYSTRUCTNAME.MS

Gibt die Metadateneinstellungen an.

Wenn dieses Feld so festgelegt 1 ist, dass die Metadaten als Teil einer erweiterten Daten-LBA übertragen werden. Dieses Feld wird gelöscht, 0 wenn die Metadaten als Teil eines separaten Puffers übertragen werden. Die Metadaten können Schutzinformationen enthalten, basierend auf dem Feld "Schutzinformationen(PI)". Wenn das Feld 'Metadatengröße MS ' des ausgewählten LBA-Formats ausgewählt ist 0h, gilt dieses Feld nicht.

DUMMYSTRUCTNAME.PI

Ein NVME_PROTECTION_INFORMATION_TYPES Enumerationswert, der angibt, ob der End-to-End-Datenschutz aktiviert ist, und den Typ der Schutzinformationen.

DUMMYSTRUCTNAME.PIL

Gibt den Speicherort der Schutzinformationen an.

Wenn dieser Wert auf 1 und Schutzinformationen aktiviert ist, werden Schutzinformationen als die ersten acht Bytes von Metadaten übertragen. Wenn Lösch 0 - und Schutzinformationen aktiviert sind, werden Schutzinformationen als die letzten acht Bytes von Metadaten übertragen. Diese Einstellung wird im Feld "Formatierte LBA Size LBAF " der Datenstruktur "Namespace identifizieren" gemeldet.

DUMMYSTRUCTNAME.SES

Ein NVME_SECURE_ERASE_SETTINGS Enumerationswert, der angibt, ob ein sicherer Löschvorgang als Teil des Formats und des Typs des vorgangs für sicheres Löschen ausgeführt werden soll. Das Löschen gilt unabhängig vom Standort für alle Benutzerdaten. Beispielsweise innerhalb einer offengelegten LBA, innerhalb eines Caches oder innerhalb von deallocated LBAs.

DUMMYSTRUCTNAME.ZF

DUMMYSTRUCTNAME.Reserved

AsUlong

Anforderungen

Siehe auch

• NVME_IDENTIFY_NAMESPACE_DATA
• NVME_LBA_FORMAT