通过

NVME_CDW10_FORMAT_NVM union (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

一个 NVME_LBA_FORMAT 值，该值指定要应用于 NVM 媒体的 LBA 格式。 只能选择支持的 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 并启用保护信息，则保护信息将作为元数据的前八个字节传输。 如果清除并 0 启用了保护信息，则保护信息将作为元数据的最后八个字节传输。 此设置在标识命名空间数据结构的“格式化 LBA 大小 LBAF”字段中报告。

DUMMYSTRUCTNAME.SES

一个 NVME_SECURE_ERASE_SETTINGS 枚举值，该值指定是否应在安全擦除操作的格式和类型中执行安全擦除。 无论位置如何，擦除都会应用于所有用户数据。 例如，在公开的 LBA 中、缓存中或解除分配的 LBA 中。

DUMMYSTRUCTNAME.ZF

DUMMYSTRUCTNAME.Reserved

AsUlong

要求

要求 值
最低受支持的客户端 Windows 10
标头 nvme.h

另请参阅