共用方式為

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

包含生命週期前的資訊。 此成員會提供裝置生命週期的相關信息，如保留區塊的平均數目所反映。 包含下列其中一個值：

值 Description
0x00 未定義成員。
0x01 一般。 取用的保留區塊少於80%。
0x02 已取用 80% 的保留區塊。
0x03 嚴重。 已耗用90%的保留區塊。
所有其他的值 保留供未來使用。

bDeviceLifeTimeEstA

bDeviceLifeTimeEstA 會根據執行的程式數量和清除週期，提供裝置預估的估計生命週期使用量。 此計算是廠商特定的，且稱為方法 A。包含下列其中一個值：

值 Description
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 完成 1000%時，dRefreshProgress 為 10000 (dec) 。 當 dRefreshProgress 完成一個百分比時，dRefreshProgress 為 1000 (十進位) 。 當此值達到 100000 (100.000%) 時：

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

備註

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

規格需求

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

另請參閱