объединение 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

См. также раздел