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 达到 1000000 (100.000%) 时， dRefreshTotalCount 递增 1。

dRefreshProgress

dRefreshProgress 以百分比形式指定刷新进度。 dRefreshProgress 以十进制表示 0.000% 到 100.000%。 完成 100% 时，dRefreshProgress 为 100000 (dec) 。 dRefreshProgress 在完成 1% 时为 1000 (十进制) 。 当此值达到 100000 (100.000%) ：

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

注解

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

要求

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

另请参阅

• 通用闪存存储 4.0 规范