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

Consulte también

Códigos de error y éxito

IAMExtDevice (Interfaz)

IAMExtDevice::p ut_DevicePower