IMDSPDevice::GetPowerSource-Methode (mswmdm.h)
Die GetPowerSource-Methode gibt an, ob das Gerät mit Akkus, externem Strom oder beidem ausgeführt werden kann und auf welcher Art von Stromquelle es gerade ausgeführt wird. Wenn das Gerät mit Batterien ausgeführt wird, meldet diese Methode auch den Prozentsatz der verbleibenden Gesamtleistung in den Batterien.
Syntax
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
Parameter
[out] pdwPowerSource
Zeiger auf ein DWORD , das einen Wert empfängt, der die aktuelle Energiequelle für das Gerät angibt. Der Wert ist eines der folgenden Flags.
| Flag | Beschreibung |
|---|---|
| WMDM_POWER_CAP_BATTERY | Das Mediengerät kann mit Batterien ausgeführt werden. |
| WMDM_POWER_CAP_EXTERNAL | Das Mediengerät kann mit externer Stromversorgung ausgeführt werden. |
| WMDM_POWER_IS_BATTERY | Das Mediengerät wird derzeit mit Batterien ausgeführt. |
| WMDM_POWER_IS_EXTERNAL | Das Mediengerät wird derzeit mit externer Stromversorgung ausgeführt. |
| WMDM_POWER_PERCENT_AVAILABLE | Der Prozentsatz der verbleibenden Leistung wurde in pdwPercentRemaining zurückgegeben. |
[out] pdwPercentRemaining
Wenn das Gerät mit Batterien ausgeführt wird, gibt pdwPercentRemaining einen Zeiger auf ein DWORD an, der den Prozentsatz der verbleibenden Gesamtbatterieleistung enthält.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:
- Com-Standardfehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Nur physische Geräte melden Energiequellenfunktionen und aktuelle Stromquelle. Softwareimplementierungen von Geräten melden keine Energiefunktionen oder aktuelle Stromquelle.
Diese Methode ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |