METODE IMDSPDevice::GetPowerSource (mswmdm.h)
Metode GetPowerSource melaporkan apakah perangkat mampu berjalan pada baterai, daya eksternal, atau keduanya, dan pada jenis sumber daya mana yang saat ini dijalankannya. Jika perangkat berjalan pada baterai, metode ini juga melaporkan persentase total daya yang tersisa dalam baterai.
Sintaks
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
Parameter
[out] pdwPowerSource
Penunjuk ke DWORD yang menerima nilai yang menunjukkan sumber daya saat ini untuk perangkat. Nilai adalah salah satu bendera berikut.
Bendera | Deskripsi |
---|---|
WMDM_POWER_CAP_BATTERY | Perangkat media dapat berjalan pada baterai. |
WMDM_POWER_CAP_EXTERNAL | Perangkat media dapat berjalan pada daya eksternal. |
WMDM_POWER_IS_BATTERY | Perangkat media saat ini berjalan pada baterai. |
WMDM_POWER_IS_EXTERNAL | Perangkat media saat ini berjalan pada daya eksternal. |
WMDM_POWER_PERCENT_AVAILABLE | Persentase sisa daya dikembalikan dalam pdwPercentRemaining. |
[out] pdwPercentRemaining
Jika perangkat berjalan pada baterai, pdwPercentRemaining menentukan pointer ke DWORD yang berisi persentase total daya baterai yang tersisa.
Nilai kembali
Metode mengembalikan HRESULT. Semua metode antarmuka di Windows Media Device Manager dapat mengembalikan salah satu kelas kode kesalahan berikut:
- Kode kesalahan COM standar
- Kode kesalahan Windows dikonversi ke nilai HRESULT
- Kode galat Pengelola Perangkat Windows Media
Keterangan
Hanya perangkat fisik yang melaporkan kemampuan sumber daya dan sumber daya saat ini. Implementasi perangkat lunak perangkat tidak melaporkan kemampuan daya atau sumber daya saat ini.
Metode ini bersifat opsional. Untuk informasi selengkapnya, lihat Antarmuka Wajib dan Opsional.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | mswmdm.h |
Pustaka | Mssachlp.lib |