Método IMDSPDevice::GetPowerSource (mswmdm.h)

  • Artículo

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
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

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

Consulte también

Interfaz IMDSPDevice