UFS_DEVICE_HEALTH_DESCRIPTOR结构 （ufs.h）

UFS_DEVICE_HEALTH_DESCRIPTOR 结构描述设备的运行状况。

语法

typedef struct {
  UCHAR bLength;
  UCHAR bDescriptorIDN;
  UCHAR bPreEOLInfo;
  UCHAR bDeviceLifeTimeEstA;
  UCHAR bDeviceLifeTimeEstB;
  UCHAR VendorPropInfo[32];
  ULONG dRefreshTotalCount;
  ULONG dRefreshProgress;
} UFS_DEVICE_HEALTH_DESCRIPTOR, *PUFS_DEVICE_HEALTH_DESCRIPTOR;

成员

bLength

指定此描述符的长度（以字节为单位）。

bDescriptorIDN

指定描述符的标识值。 UFS_DEVICE_HEALTH_DESCRIPTOR 的值为 UFS_DESC_HEALTH_IDN。

bPreEOLInfo

包含生命周期前的信息。 此成员提供有关设备生存期的信息，如保留块的平均数量所反映。 包含以下值之一：

价值	描述
0x00	未定义成员。
0x01	正常。 占用的保留块数少于 80%。
0x02	已使用 80 个保留块%。
0x03	危急。 已使用 90 个保留块%。
所有其他值	保留以供将来使用。

bDeviceLifeTimeEstA

bDeviceLifeTimeEstA 根据执行的程序和擦除周期量提供设备估计生命周期的估计量。 此计算特定于供应商，称为方法 A。包含以下值之一：

价值	描述
0x00	找不到有关设备生存时间的信息。
0x01	已使用设备的估计生命周期的 0% 到 10%。
0x02	已使用设备的估计生存时间的 10% 到 20%。
0x03	已使用设备的估计生命周期的 20% 到 30%。
0x04	已使用设备的估计生命周期的 30% 到 40%。
0x05	已使用设备的估计生命周期的 40% 到 50%。
0x06	已使用设备估计生命周期的 50% 到 60%。
0x07	已使用设备的估计生存时间的 60% 到 70%。
0x08	已使用设备估计生命周期的 70% 到 80%。
0x09	已使用设备的估计生命周期的 80% 到 90%。
0x0A	已使用设备的估计生命周期的 90% 到 100%。
0x0B	设备已超过估计生存时间。
所有其他值	保留以供将来使用。

bDeviceLifeTimeEstB

bDeviceLifeTimeEstB 根据执行的程序和擦除周期量提供设备估计生命周期的估计量。 此计算特定于供应商，称为方法 B。包含与 bDeviceLifeTimeEstA 相同的值。

VendorPropInfo[32]

保留给供应商专有运行状况报告。

dRefreshTotalCount

dRefreshTotalCount 指定设备为整个设备完成刷新的次数。 当 dRefreshProgress 达到 100000 （100.000%）时，dRefreshTotalCount 递增 1。

dRefreshProgress

dRefreshProgress 指定刷新进度（以百分比为单位）。 dRefreshProgress 以十进制表示 0.000% 到 100.000%。 dRefreshProgress 完成 100000%时为 100000（dec）。 dRefreshProgress 在完成百分之一时为 1000（decimal）。 当此值达到 100000 （100.000%）：

1. 设备停止刷新。
2. dRefreshProgress 重置为零。
3. dRefreshTotalCount 递增一个。

言论

UFS 主机控制器包含一系列可配置的描述符表，允许驱动程序查询和配置主机控制器的功能。 从设备上的描述符表中查询请求的描述符。

要求

要求	价值
最低支持的客户端	Windows 10 版本 1709
支持的最低服务器	Windows Server 2016
标头	ufs.h

另请参阅

• 通用闪存存储 4.0 规范