Compartilhar via


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