Freigeben über

IMDSPDevice::GetPowerSource-Methode (mswmdm.h)

  • Artikel

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
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter 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

Weitere Informationen

IMDSPDevice-Schnittstelle