UFS_DEVICE_HEALTH_DESCRIPTOR-Struktur (ufs.h)
Die UFS_DEVICE_HEALTH_DESCRIPTOR-Struktur beschreibt die Integrität eines Geräts.
Syntax
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;
Member
bLength
Gibt die Länge dieses Deskriptors in Bytes an.
bDescriptorIDN
Gibt den Identifikationswert des Deskriptors an. UFS_DEVICE_HEALTH_DESCRIPTOR weist den Wert UFS_DESC_HEALTH_IDN auf.
bPreEOLInfo
Enthält Pre-End-of-Life-Informationen. Dieses Element stellt Informationen zur Lebensdauer eines Geräts bereit, die sich aus der durchschnittlichen Anzahl reservierter Blöcke widerspiegelt. Enthält einen der folgenden Werte:
| Wert | BESCHREIBUNG |
|---|---|
| 0x00 | Member ist nicht definiert. |
| 0x01 | Normal. Verbraucht weniger als 80 % der reservierten Blöcke. |
| 0x02 | Verbraucht 80 % der reservierten Blöcke. |
| 0x03 | Kritisch. Verbraucht 90 % der reservierten Blöcke. |
| Alle anderen Werte | Für die zukünftige Verwendung reserviert. |
bDeviceLifeTimeEstA
bDeviceLifeTimeEstA bietet eine Schätzung, wie viel der geschätzten Lebensdauer eines Geräts basierend auf der Anzahl der ausgeführten Programm- und Löschzyklen genutzt wurde. Diese Berechnung ist anbieterspezifisch und wird als Methode A bezeichnet. Enthält einen der folgenden Werte:
| Wert | BESCHREIBUNG |
|---|---|
| 0x00 | Informationen zur Lebensdauer des Geräts wurden nicht gefunden. |
| 0x01 | 0% bis 10% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x02 | 10% bis 20% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x03 | 20% bis 30% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x04 | 30% bis 40% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x05 | 40% bis 50% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x06 | 50% bis 60% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x07 | 60% bis 70% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x08 | 70% bis 80% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x09 | 80% bis 90% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x0A | 90% bis 100% der geschätzten Lebensdauer des Geräts wurden genutzt. |
| 0x0B | Das Gerät hat seine geschätzte Lebensdauer überschritten. |
| Alle anderen Werte | Für die zukünftige Verwendung reserviert. |
bDeviceLifeTimeEstB
bDeviceLifeTimeEstB bietet eine Schätzung, wie viel der geschätzten Lebensdauer eines Geräts basierend auf der Menge der ausgeführten Programm- und Löschzyklen genutzt wurde. Diese Berechnung ist herstellerspezifisch und wird als Methode B bezeichnet. Enthält die gleichen möglichen Werte wie bDeviceLifeTimeEstA.
VendorPropInfo[32]
Reserviert für den herstellereigenen Integritätsbericht.
dRefreshTotalCount
dRefreshTotalCount gibt an, wie oft das Gerät die Aktualisierung für das gesamte Gerät abgeschlossen hat. dRefreshTotalCount wird um eins erhöht, wenn dRefreshProgress 100000 erreicht (100.000 %).
dRefreshProgress
dRefreshProgress gibt den Aktualisierungsfortschritt in Prozent an. dRefreshProgress gibt 0.000% bis 100.000% in dezimal an. dRefreshProgress ist 100000 (dec), wenn es zu 100 Prozent abgeschlossen ist. dRefreshProgress ist 1000 (dezimal), wenn ein Prozent abgeschlossen wird. Wenn dieser Wert 100000 (100.000%) erreicht:
- Das Gerät wird nicht mehr aktualisiert.
- dRefreshProgress wird auf Null zurückgesetzt.
- dRefreshTotalCount wird um eins erhöht.
Hinweise
Der UFS-Hostcontroller enthält eine Reihe konfigurierbarer Deskriptortabellen, mit denen der Treiber die Funktionen des Hostcontrollers abfragen und konfigurieren kann. Fragen Sie den angeforderten Deskriptor aus der Deskriptortabelle auf dem Gerät ab.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1709 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Kopfzeile | ufs.h |