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 會遞增一個 。

dRefreshProgress

dRefreshProgress 指定百分比的重新整理進度。 dRefreshProgress 表示十進位數中的 0.000% 到 100.000%。 dRefreshProgress 完成 100000%時為 100000（dec）。 dRefreshProgress 在完成百分之一時為 1000（十進位）。 當此值達到 100000 （100.000%時：

1. 裝置會停止重新整理。
2. dRefreshProgress 重設為零。
3. dRefreshTotalCount 會遞增一個。

言論

UFS 主機控制器包含一系列的可設定描述元數據表，可讓驅動程式查詢及設定主控制器的功能。 從裝置上的描述元數據表查詢要求的描述元。

要求

要求	價值
最低支援的用戶端	Windows 10 版本 1709
支援的最低伺服器	Windows Server 2016
標頭	ufs.h

另請參閱

• 通用快閃記憶體 4.0 規格