Microsoft DirectX 8.1 (C++)

IAMExtDevice::get_DevicePower

The get_DevicePower method retrieves the external device's power mode: on, off, or standby.

Syntax

HRESULT get_DevicePower(
  long *pPowerMode
);

Parameters

pPowerMode

[out]  Pointer to a long integer that receives one of the following values, indicating the device's power mode.

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

MSDV returns the ED_POWER_ON flag when the camcorder is on. If the camcorder is off or in standby mode, the DV driver is not loaded, so this method is not available. If the camcorder is removed unexpectedly, the method can return ERROR_GEN_FAILURE.

MSTape supports both ED_POWER_OFF and ED_POWER_ON, but not ED_POWER_STANDBY.

See Also