ITAutomatedPhoneControl::get_AutoVolumeControl method (tapi3if.h)

The get_AutoVolumeControl method retrieves the current value of the AutoVolumeControl property. When this feature is enabled, the phone's wave output volume is automatically adjusted whenever a volume button is pressed. The volume is adjusted by the amount indicated by the AutoVolumeControlStep property.

Syntax

HRESULT get_AutoVolumeControl(
  [out] VARIANT_BOOL *fEnabled
);

Parameters

[out] fEnabled

VARIANT_TRUE indicates that automatic volume control is enabled. VARIANT_FALSE indicates that automatic volume control is disabled.

Return value

If the method succeeds, it returns S_OK. Otherwise, it returns an error value.

Remarks

You can set the AutoVolumeControl property at any time. The reconfiguration takes effect the next time a volume button is pressed.

The AutoVolumeControl property functions only when the value of the PhoneHandlingEnabled property is VARIANT_TRUE.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

ITAutomatedPhoneControl

put_AutoVolumeControl

put_AutoVolumeControlStep

put_PhoneHandlingEnabled