Método IMDSPDevice::GetPowerSource (mswmdm.h)
El método GetPowerSource informa de si el dispositivo es capaz de ejecutarse en baterías, energía externa o ambos, y en qué tipo de fuente de alimentación se está ejecutando actualmente. Si el dispositivo se está ejecutando en baterías, este método también informa del porcentaje de energía total restante en las baterías.
Sintaxis
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
Parámetros
[out] pdwPowerSource
Puntero a un DWORD que recibe un valor que indica la fuente de alimentación actual del dispositivo. El valor es una de las marcas siguientes.
| Marca | Descripción |
|---|---|
| WMDM_POWER_CAP_BATTERY | El dispositivo multimedia puede funcionar con baterías. |
| WMDM_POWER_CAP_EXTERNAL | El dispositivo multimedia se puede ejecutar en energía externa. |
| WMDM_POWER_IS_BATTERY | El dispositivo multimedia se está ejecutando actualmente en baterías. |
| WMDM_POWER_IS_EXTERNAL | El dispositivo multimedia se está ejecutando actualmente en energía externa. |
| WMDM_POWER_PERCENT_AVAILABLE | El porcentaje de energía restante se devolvió en pdwPercentRemaining. |
[out] pdwPercentRemaining
Si el dispositivo se ejecuta en baterías, pdwPercentRemaining especifica un puntero a un DWORD que contiene el porcentaje de energía total de la batería restante.
Valor devuelto
El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:
- Códigos de error COM estándar
- Códigos de error de Windows convertidos en valores HRESULT
- Códigos de error de windows Media Administrador de dispositivos
Comentarios
Solo los dispositivos físicos notifican funcionalidades de fuente de alimentación y fuente de alimentación actual. Las implementaciones de software de los dispositivos no notifican funcionalidades de alimentación ni fuente de alimentación actual.
Este método es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |