Metodo IMDSPDevice::GetPowerSource (mswmdm.h)
Il metodo GetPowerSource segnala se il dispositivo è in grado di eseguire batterie, alimentazione esterna o entrambe e su quale tipo di fonte di alimentazione è attualmente in esecuzione. Se il dispositivo è in esecuzione su batterie, questo metodo segnala anche la percentuale di energia totale rimanente nelle batterie.
Sintassi
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
Parametri
[out] pdwPowerSource
Puntatore a un DWORD che riceve un valore che indica l'origine di alimentazione corrente per il dispositivo. Il valore è uno dei flag seguenti.
| Flag | Descrizione |
|---|---|
| WMDM_POWER_CAP_BATTERY | Il dispositivo multimediale può essere eseguito su batterie. |
| WMDM_POWER_CAP_EXTERNAL | Il dispositivo multimediale può essere eseguito in alimentazione esterna. |
| WMDM_POWER_IS_BATTERY | Il dispositivo multimediale è attualmente in esecuzione sulle batterie. |
| WMDM_POWER_IS_EXTERNAL | Il dispositivo multimediale è attualmente in esecuzione in alimentazione esterna. |
| WMDM_POWER_PERCENT_AVAILABLE | La percentuale di energia rimanente è stata restituita in pdwPercentRemaining. |
[out] pdwPercentRemaining
Se il dispositivo è in esecuzione su batterie, pdwPercentRemaining specifica un puntatore a un DWORD contenente la percentuale di energia totale della batteria rimanente.
Valore restituito
Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:
- Codici di errore COM standard
- Codici di errore di Windows convertiti in valori HRESULT
- Codici di errore di Windows Media Gestione dispositivi
Commenti
Solo i dispositivi fisici segnalano le funzionalità di alimentazione e l'alimentazione corrente. Le implementazioni software dei dispositivi segnalano nessuna funzionalità di alimentazione o alimentazione corrente.
È facoltativo. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |