Método IAMExtDevice::get_DevicePower (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O get_DevicePower método recupera o modo de energia do dispositivo externo.
Sintaxe
HRESULT get_DevicePower(
[out] long *pPowerMode
);
Parâmetros
[out] pPowerMode
Ponteiro para um inteiro longo que recebe um dos valores a seguir, indicando o modo de energia do dispositivo.
| Valor | Descrição |
|---|---|
| ED_POWER_OFF | A energia está desligada. |
| ED_POWER_ON | Ligar se ativado. |
| ED_POWER_STANDBY | O dispositivo está em modo de espera. |
Retornar valor
Quando esse método é bem-sucedido, ele retorna S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
No Windows XP Service Pack 2 e posterior, o modo de energia adicional a seguir é definido.
| Valor | Descrição |
|---|---|
| ED_POWER_DEVICE_DEPENDENT | A energia está ativada com funções limitadas. |
Para usar essa constante, inclua o arquivo de cabeçalho Xprtdefs.h.
Implementação de camcorder DV e MPEG
Os drivers MSDV e UVC retornam ED_POWER_ON quando a câmera está ativada. Se a filmadora estiver desativada ou em modo de espera, o driver DV não será carregado, portanto, esse método não estará disponível. Se o filmador for removido inesperadamente, o método poderá retornar ERROR_GEN_FAILURE.O MSTape dá suporte a ED_POWER_OFF e ED_POWER_ON, mas não a ED_POWER_STANDBY.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |