STORAGE_PROTOCOL_NVME_DATA_TYPE 枚举 (ntddstor.h)

项目
02/26/2024

描述在 IOCTL_STORAGE_QUERY_PROPERTY 请求期间要查询的特定于 NVMe 协议的数据的类型。

语法

typedef enum _STORAGE_PROTOCOL_NVME_DATA_TYPE {
  NVMeDataTypeUnknown,
  NVMeDataTypeIdentify,
  NVMeDataTypeLogPage,
  NVMeDataTypeFeature
} STORAGE_PROTOCOL_NVME_DATA_TYPE, *PSTORAGE_PROTOCOL_NVME_DATA_TYPE;

常量


`NVMeDataTypeUnknown` 未知的数据类型。
`NVMeDataTypeIdentify` 获取标识数据，可以是标识控制器数据或标识命名空间数据。查询此类数据时， STORAGE_PROTOCOL_SPECIFIC_DATA 结构中的字段应具有以下值： * 将针对适配器NVME_IDENTIFY_CNS_CONTROLLERProtocolDataRequestValue，或为命名空间NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE。 * 如果 ProtocolDataRequestValueNVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE，则 ProtocolDataRequestSubValue 字段指定命名空间 ID。 (请注意，当前不支持 NVME_IDENTIFY_CNS_ACTIVE_NAMESPACES 。)
`NVMeDataTypeLogPage` 获取 NVMe 日志页。查询此类数据时， STORAGE_PROTOCOL_SPECIFIC_DATA 结构中的字段应具有以下值： * ProtocolDataRequestValue 是要检索的日志页的标识符。 * ProtocolDataRequestSubValue 是日志页中从中开始返回数据的偏移量的较低 32 位值。 * ProtocolDataRequestSubValue2 是日志页中从中开始返回数据的偏移量的 32 位上限值。 * ProtocolDataRequestSubValue3 是特定日志页所需的特定于日志的标识符。 * ProtocolDataRequestSubValue4 是一种 STORAGE_PROTOCOL_DATA_SUBVALUE_GET_LOG_PAGE 结构，允许在获取日志页时指定其他信息。
`NVMeDataTypeFeature` 特征数据类型。

注解

使用 IOCTL_STORAGE_QUERY_PROPERTY 检索 STORAGE_PROTOCOL_DATA_DESCRIPTOR中特定于协议的信息时，请按如下所示配置 STORAGE_PROPERTY_QUERY 结构：

分配可以同时包含 STORAGE_PROPERTY_QUERY 和 STORAGE_PROTOCOL_SPECIFIC_DATA 结构的缓冲区。
分别将控制器或设备/命名空间请求的 PropertyID 字段设置为 StorageAdapterProtocolSpecificProperty 或 StorageDeviceProtocolSpecificProperty。
将 QueryType 字段设置为 PropertyStandardQuery。
使用所需的值填充 STORAGE_PROTOCOL_SPECIFIC_DATA 结构。 STORAGE_PROTOCOL_SPECIFIC_DATA 的开头是 STORAGE_PROPERTY_QUERY 的 AdditionalParameters 字段。

若要指定特定于 NVMe 协议的信息类型，请配置 STORAGE_PROTOCOL_SPECIFIC_DATA 结构，如下所示：

将 ProtocolType 字段设置为 ProtocolTypeNVMe。
将 DataType 字段设置为 STORAGE_PROTOCOL_NVME_DATA_TYPE 定义的枚举值：
- 使用 NVMeDataTypeIdentify 获取标识控制器数据或标识命名空间数据。
- 使用 NVMeDataTypeLogPage 获取日志页（包括 SMART/health 数据）。
- 使用 NVMeDataTypeFeature 获取 NVMe 驱动器的功能。