Método IAMExtDevice::get_DevicePower (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El get_DevicePower método recupera el modo de alimentación del dispositivo externo.
Sintaxis
HRESULT get_DevicePower(
[out] long *pPowerMode
);
Parámetros
[out] pPowerMode
Puntero a un entero largo que recibe uno de los valores siguientes, lo que indica el modo de alimentación del dispositivo.
| Valor | Descripción |
|---|---|
| ED_POWER_OFF | La alimentación está apagada. |
| ED_POWER_ON | Encendido si está encendido. |
| ED_POWER_STANDBY | El dispositivo está en modo de espera. |
Valor devuelto
Cuando este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .
Observaciones
En Windows XP Service Pack 2 y versiones posteriores, se define el siguiente modo de alimentación adicional.
| Valor | Descripción |
|---|---|
| ED_POWER_DEVICE_DEPENDENT | La alimentación está activada con funciones limitadas. |
Para usar esta constante, incluya el archivo de encabezado Xprtdefs.h.
Implementación de videocámara DV y MPEG
Los controladores MSDV y UVC devuelven ED_POWER_ON cuando la videocámara está activada. Si la videocámara está apagada o en modo de espera, el controlador DV no se carga, por lo que este método no está disponible. Si la videocámara se quita inesperadamente, el método puede devolver ERROR_GEN_FAILURE.MSTape admite tanto ED_POWER_OFF como ED_POWER_ON, pero no ED_POWER_STANDBY.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |
| Library | Strmiids.lib |