NVME_CDW10_FORMAT_NVM Union (nvme.h)
Enthält Parameter für den NvM-Befehl formatieren, der zum Low-Level-Formatieren der NVM-Medien verwendet wird.
Dieser Befehl wird verwendet, wenn der Host die LBA-Datengröße (Logical Block Address) und/oder die Metadatengröße ändern möchte. Ein Low-Level-Format kann alle Daten und Metadaten zerstören, die allen Namespaces oder nur dem spezifischen Namespace zugeordnet sind, der dem Befehl zugeordnet ist (siehe FormatIEREN von NVM-Attributen im Feld Optional Admin Command Support (OACS) der Datenstruktur Des Controllers identifizieren). Nachdem der Befehl NVM format erfolgreich abgeschlossen wurde, gibt der Controller keine Benutzerdaten zurück, die zuvor in einem betroffenen Namespace enthalten waren.
Der Befehl Format NVM verwendet das Feld Command Dword 10 CDW10 im FORMATNVM-Parameter der Command-Struktur . 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;
Member
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 auf 1 festgelegt ist, wenn die Metadaten im Rahmen einer erweiterten LBA für Daten übertragen werden. Dieses Feld wird in 0 gelöscht, wenn die Metadaten als Teil eines separaten Puffers übertragen werden. Die Metadaten können Schutzinformationen enthalten, die auf dem Feld Schutzinformationen (PI) basieren. Wenn das Feld Metadatengröße MS des ausgewählten LBA-Formats lautet 0h, ist dieses Feld nicht anwendbar.
DUMMYSTRUCTNAME.PI
Ein NVME_PROTECTION_INFORMATION_TYPES Enumerationswert, der angibt, ob End-to-End-Datenschutz aktiviert ist, und den Typ der Schutzinformationen.
DUMMYSTRUCTNAME.PIL
Gibt den Speicherort der Schutzinformationen an.
Wenn dieser Wert auf 1 festgelegt ist und Schutzinformationen aktiviert sind, werden Schutzinformationen als die ersten acht Bytes der Metadaten übertragen. Wenn für gelöscht und 0 Schutzinformationen aktiviert sind, werden Schutzinformationen als die letzten acht Bytes der Metadaten übertragen. Diese Einstellung wird im LBAF-Feld Formatierte LBA-Größe der Datenstruktur Namespace identifizieren gemeldet.
DUMMYSTRUCTNAME.SES
Ein NVME_SECURE_ERASE_SETTINGS Enumerationswert, der angibt, ob eine sichere Löschung als Teil des Formats und des Typs des Vorgangs für die sichere Löschung ausgeführt werden soll. Die Löschung gilt für alle Benutzerdaten, unabhängig vom Standort. Beispielsweise innerhalb eines verfügbar gemachten LBA, innerhalb eines Caches oder innerhalb von freigegebenen LBAs.
DUMMYSTRUCTNAME.ZF
DUMMYSTRUCTNAME.Reserved
AsUlong
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Kopfzeile | nvme.h |