NVME_CDW11_FEATURES union (nvme.h)

  • 项目

包含用于检索或设置指定特征的属性的“获取特征”和“设置特征”命令的参数。

此结构用于命令结构中 GETFEATURES 和 SETFEATURES 字段的 CDW11 参数。

语法

typedef union {
  NVME_CDW11_FEATURE_NUMBER_OF_QUEUES              NumberOfQueues;
  NVME_CDW11_FEATURE_INTERRUPT_COALESCING          InterruptCoalescing;
  NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG       InterruptVectorConfig;
  NVME_CDW11_FEATURE_LBA_RANGE_TYPE                LbaRangeType;
  NVME_CDW11_FEATURE_ARBITRATION                   Arbitration;
  NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE          VolatileWriteCache;
  NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG            AsyncEventConfig;
  NVME_CDW11_FEATURE_POWER_MANAGEMENT              PowerManagement;
  NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION   AutoPowerStateTransition;
  NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD         TemperatureThreshold;
  NVME_CDW11_FEATURE_ERROR_RECOVERY                ErrorRecovery;
  NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER            HostMemoryBuffer;
  NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL        WriteAtomicityNormal;
  NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE   NonOperationalPowerState;
  NVME_CDW11_FEATURE_IO_COMMAND_SET_PROFILE        IoCommandSetProfile;
  NVME_CDW11_FEATURE_ERROR_INJECTION               ErrorInjection;
  NVME_CDW11_FEATURE_HOST_IDENTIFIER               HostIdentifier;
  NVME_CDW11_FEATURE_RESERVATION_PERSISTENCE       ReservationPersistence;
  NVME_CDW11_FEATURE_RESERVATION_NOTIFICATION_MASK ReservationNotificationMask;
  NVME_CDW11_FEATURE_GET_HOST_METADATA             GetHostMetadata;
  NVME_CDW11_FEATURE_SET_HOST_METADATA             SetHostMetadata;
  ULONG                                            AsUlong;
} NVME_CDW11_FEATURES, *PNVME_CDW11_FEATURES;

成员

NumberOfQueues

指定一个 NVME_CDW11_FEATURE_NUMBER_OF_QUEUES 结构，其中包含指示主机为此控制器请求的队列数的值。

为“队列数”功能提交“设置功能”或“获取功能”命令时，将在该命令的“完成队列”条目的 Dword 0 (DW0) 字段中返回NVME_CDW11_FEATURE_NUMBER_OF_QUEUES结构。

InterruptCoalescing

指定一个 NVME_CDW11_FEATURE_INTERRUPT_COALESCING 结构，其中包含配置中断合并设置的值。

为中断合并功能提交“获取功能”命令时，将在该命令的完成队列条目的 DW0 字段中返回NVME_CDW11_FEATURE_INTERRUPT_COALESCING结构的 TIME 和 THR 字段中指定的值。

InterruptVectorConfig

指定一个 NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG 结构，其中包含配置特定于特定中断向量的设置的值。

为中断向量配置功能提交 Get Features 命令时，将在该命令的完成队列条目的 DW0 字段中返回NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG结构的中断向量 (IV) 和合并禁用 (CD) 字段中指定的值。

在发出此功能之前，主机应使用有效的 I/O 完成队列配置指定的中断向量。 如果指定的 I/O 完成队列或中断向量无效，则控制器将返回 NVME_STATUS_INVALID_FIELD_IN_COMMAND状态。

LbaRangeType

指定一个 NVME_CDW11_FEATURE_LBA_RANGE_TYPE结构， 其中包含一个值，该值指定“设置特征”命令中 LBA 范围类型功能的 LBA 范围的数目。

此字段仅用于“设置功能”命令，对于“获取功能”命令，将忽略此字段。

LBA 范围类型功能指定逻辑块分配的类型和属性 (LBA) 指定命名空间的一部分。 该功能使用 NVME_CDW11_FEATURE_LBA_RANGE_TYPE 结构指定 LBA 范围的数量， 并使用NVME_LBA_RANGET_TYPE_ENTRY 数据结构指定类型和属性信息。

为 LBA 范围类型功能提交 Get Features 命令时，将在完成队列条目的 DW0 字段中返回NVME_CDW11_FEATURE_LBA_RANGE_TYPE结构的 NUM 字段中指定的值，并在该命令的数据缓冲区中返回 LBA 范围类型NVME_LBA_RANGET_TYPE_ENTRY数据结构。

Arbitration

指定包含控制命令仲裁的值 的NVME_CDW11_FEATURE_ARBITRATION 结构。

为仲裁功能提交“获取功能”命令时，将在该命令的“完成队列”条目的 DW0 字段中返回此字段中指定的结构。

VolatileWriteCache

指定一个 NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE 结构，其中包含控制控制器上易失性写入缓存（如果存在）的值。

为易失性写入缓存功能提交“获取功能”命令时，NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE的 WCE 字段中指定的值将在该命令的“完成队列项”的 DW0 字段中返回。

AsyncEventConfig

指定包含异步事件配置功能参数 的NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG 结构，该功能控制触发向主机发出异步事件通知的事件。

为异步事件配置功能提交“获取功能”命令时，将在该命令的“完成队列条目”结构的 DW0 字段中返回“NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG结构”中指定的值。

PowerManagement

指定一个 NVME_CDW11_FEATURE_POWER_MANAGEMENT 结构，其中包含允许主机配置电源状态的值。

为 Power Management 功能提交“获取功能”命令时，将在该命令的“完成队列”条目的 DW0 字段中返回NVME_CDW11_FEATURE_POWER_MANAGEMENT结构。

AutoPowerStateTransition

指定一个 NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION结构， 其中包含用于配置自治电源状态转换设置的自治电源状态转换功能的参数。

自治电源状态转换功能指定 NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION 数据结构和 自治电源状态转换入口 数据结构中的属性信息。

为自治电源状态转换功能提交“获取功能”命令时，将在完成队列条目的 DW0 字段中返回NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION结构的 APSTE 字段中指定的值，并在该命令的数据缓冲区中返回NVME_AUTO_POWER_STATE_TRANSITION_ENTRY数据结构。

TemperatureThreshold

指定 NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD 结构，其中包含用于设置或检索控制器的温度阈值的值。

ErrorRecovery

HostMemoryBuffer

指定包含用于控制主机内存缓冲区的值 的NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER 结构。

主机内存缓冲区功能为主机分配部分主机内存供控制器独占使用的机制。 成功完成启用主机内存缓冲区的“设置功能”命令后，在禁用主机内存缓冲区之前，主机不会写入关联的主机内存区域、缓冲区大小或描述符列表。 成功完成禁用主机内存缓冲区的“设置功能”命令后，控制器将不会访问主机内存缓冲区中的任何数据，直到启用主机内存缓冲区。

主机内存描述符列表是主机内存中物理连续的数据结构，用于描述主机内存缓冲区的地址和长度对。 列表的边界和内容在以下字段和结构中定义：

WriteAtomicityNormal

指定一个 NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL 结构，其中包含用于控制原子写入单元正常 (AWUN) 和命名空间原子写入单元正常 (NAWUN 的操作的值) 参数，这些参数定义控制器对原子操作的支持。

为写入原子性正常功能提交“获取功能”命令时，将在该命令的“完成队列条目”结构的 DW0 字段中返回“NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL结构”中指定的值。

NonOperationalPowerState

指定一个 NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE结构， 其中包含非操作电源状态功能的值，指示是否为非操作电源状态启用允许模式。

IoCommandSetProfile

ErrorInjection

HostIdentifier

ReservationPersistence

ReservationNotificationMask

GetHostMetadata

SetHostMetadata

AsUlong

要求

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

另请参阅