IMDSPDevice::GetPowerSource 메서드(mswmdm.h)

GetPowerSource 메서드는 디바이스가 배터리, 외부 전원 또는 둘 다에서 실행할 수 있는지 여부와 현재 실행 중인 전원 유형을 보고합니다. 장치가 배터리에서 실행되는 경우 이 방법은 배터리에 남아 있는 총 전력의 백분율도 보고합니다.

구문

HRESULT GetPowerSource(
  [out] DWORD *pdwPowerSource,
  [out] DWORD *pdwPercentRemaining
);

[out] pdwPowerSource

디바이스의 현재 전원을 나타내는 값을 수신하는 DWORD 에 대한 포인터입니다. 값은 다음 플래그 중 하나입니다.

플래그	설명
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 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

물리적 디바이스만 전원 기능 및 현재 전원을 보고합니다. 디바이스의 소프트웨어 구현은 전원 기능 또는 현재 전원을 보고하지 않습니다.

이 메서드는 선택 사항입니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.