Метод IMDSPDevice::GetPowerSource (mswmdm.h)
Метод GetPowerSource сообщает, может ли устройство работать от батареи, внешнего питания или и от того, и на каком типе источника питания оно работает в данный момент. Если устройство работает от батарей, этот метод также сообщает процент общей мощности, оставшейся в батареях.
Синтаксис
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
Параметры
[out] pdwPowerSource
Указатель на DWORD , получающий значение, указывающее текущий источник питания для устройства. Значением является один из следующих флагов.
| Flag | Описание |
|---|---|
| WMDM_POWER_CAP_BATTERY | Устройство мультимедиа может работать от батареи. |
| WMDM_POWER_CAP_EXTERNAL | Устройство мультимедиа может работать от внешнего питания. |
| WMDM_POWER_IS_BATTERY | Устройство мультимедиа в настоящее время работает на батареях. |
| WMDM_POWER_IS_EXTERNAL | Мультимедийное устройство в настоящее время работает от внешнего питания. |
| WMDM_POWER_PERCENT_AVAILABLE | Процент оставшейся мощности был возвращен в pdwPercentRemaining. |
[out] pdwPercentRemaining
Если устройство работает от батареи, pdwPercentRemaining указывает указатель на DWORD , содержащий процент общей мощности батареи.
Возвращаемое значение
Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:
- Стандартные коды ошибок COM
- Коды ошибок Windows, преобразованные в значения HRESULT
- Коды ошибок диспетчер устройств Windows Media
Комментарии
Только физические устройства сообщают о возможностях источника питания и текущем источнике питания. Программные реализации устройств не сообщают о возможностях питания или текущем источнике питания.
Этот метод является необязательным. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | mswmdm.h |
| Библиотека | Mssachlp.lib |