Metodo IAMExtDevice::get_DevicePower (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il get_DevicePower metodo recupera la modalità di alimentazione del dispositivo esterno.
Sintassi
HRESULT get_DevicePower(
[out] long *pPowerMode
);
Parametri
[out] pPowerMode
Puntatore a un intero lungo che riceve uno dei valori seguenti, che indica la modalità di alimentazione del dispositivo.
| Valore | Descrizione |
|---|---|
| ED_POWER_OFF | L'alimentazione è disattivata. |
| ED_POWER_ON | Alimentazione se attivata. |
| ED_POWER_STANDBY | Il dispositivo è in modalità standby. |
Valore restituito
Quando questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
In Windows XP Service Pack 2 e versioni successive viene definita la modalità di alimentazione aggiuntiva seguente.
| Valore | Descrizione |
|---|---|
| ED_POWER_DEVICE_DEPENDENT | L'alimentazione è attiva con funzioni limitate. |
Per usare questa costante, includere il file di intestazione Xprtdefs.h.
Implementazione DV e MPEG Camcorder
I driver MSDV e UVC restituiscono ED_POWER_ON quando si trova la videocamera. Se la videocamera è disattivata o in modalità standby, il driver DV non viene caricato, quindi questo metodo non è disponibile. Se la videocamera viene rimossa in modo imprevisto, il metodo può restituire ERROR_GEN_FAILURE.MSTape supporta sia ED_POWER_OFF che ED_POWER_ON, ma non ED_POWER_STANDBY.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |