IAMExtDevice::put_DevicePower
| Microsoft DirectShow 9.0 |
IAMExtDevice::put_DevicePower
The put_DevicePower method assigns the external device's power mode to either on, off, or standby.
Syntax
HRESULT put_DevicePower( long PowerMode );
Parameters
PowerMode
[in] Specifies the device's power mode. Use one of the following values.
| Value | Description |
| ED_POWER_OFF | Off |
| ED_POWER_ON | On |
| ED_POWER_STANDBY | Standby |
Return Values
When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.
DV and MPEG Camcorder Implementation
The MSDV and UVC drivers do not support this method. The method returns E_NOTIMPL.
MSTape supports both ED_POWER_OFF and ED_POWER_ON, but not ED_POWER_STANDBY. When the driver is loaded, it detects the power state. If the power is off, the driver will attempt to turn the device on. An application can use this method to set the power mode.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also