объединение NVME_CDW10_FORMAT_NVM (nvme.h)
Содержит параметры для команды Форматировать NVM, которая используется для низкоуровневого форматирования носителя NVM.
Эта команда используется, когда узел хочет изменить размер данных адреса логического блока (LBA) и (или) размер метаданных. Низкоуровневый формат может привести к уничтожению всех данных и метаданных, связанных со всеми пространствами имен или только с определенным пространством имен, связанным с командой (см. раздел Формат атрибутов NVM в поле Необязательная поддержка команд Администратор (OACS) структуры данных Идентификация контроллера). После успешного выполнения команды Форматировать NVM контроллер не возвращает пользовательские данные, которые ранее содержались в затронутом пространстве имен.
Команда Форматировать NVM использует поле Command Dword 10 CDW10 в параметре FORMATNVM структуры команд . Все остальные поля, относящиеся к командам, зарезервированы.
Синтаксис
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 , указывающее формат LBA для применения к носителю NVM. Можно выбрать только поддерживаемые форматы LBA. Это значение соответствует полю LBAF в структуре NVME_IDENTIFY_NAMESPACE_DATA для команды Identify.
DUMMYSTRUCTNAME.MS
Задает параметры метаданных.
Если для этого поля задано значение 1 , если метаданные передаются как часть расширенного LBA данных. Это поле очищается, 0 если метаданные передаются как часть отдельного буфера. Метаданные могут включать сведения о защите на основе поля Сведения о защите (PI). Если выбрано поле Ms Размер метаданных в формате0hLBA , то это поле неприменимо.
DUMMYSTRUCTNAME.PI
Значение перечисления NVME_PROTECTION_INFORMATION_TYPES , указывающее, включена ли сквозная защита данных и тип сведений о защите.
DUMMYSTRUCTNAME.PIL
Указывает расположение сведений о защите.
Если для этого значения задано значение 1 , а сведения о защите включены, то сведения о защите передаются в виде первых восьми байт метаданных. Если параметр 0 снят и сведения о защите включены, данные защиты передаются в виде последних восьми байт метаданных. Этот параметр отображается в поле LBAF Formatted LBA Size (Форматированный размер LBA LBAF ) структуры данных Идентификация пространства имен.
DUMMYSTRUCTNAME.SES
Значение перечисления NVME_SECURE_ERASE_SETTINGS , указывающее, следует ли выполнять безопасное стирание как часть формата и тип операции безопасного стирания. Удаление применяется ко всем пользовательским данным, независимо от расположения. Например, в предоставленной LBA, в кэше или в освобожденных LBA.
DUMMYSTRUCTNAME.ZF
DUMMYSTRUCTNAME.Reserved
AsUlong
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 |
| Верхняя часть | nvme.h |