ITAutomatedPhoneControl::put_AutoVolumeControl method (tapi3if.h)

The put_AutoVolumeControl method sets the AutoVolumeControl property for this phone. 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 put_AutoVolumeControl(
  [in] VARIANT_BOOL fEnabled
);

Parameters

[in] fEnabled

If VARIANT_TRUE, enables automatic volume control. If VARIANT_FALSE, disables automatic volume control. The default value is VARIANT_TRUE.

Return value

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

Remarks

The AutoVolumeControl property functions only when the value of the PhoneHandlingEnabled property is VARIANT_TRUE. You can set the AutoVolumeControl property at any time. The reconfiguration takes effect the next time a volume button is pressed.

Requirements

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

See also

ITAutomatedPhoneControl

get_AutoVolumeControl

put_AutoVolumeControlStep

put_PhoneHandlingEnabled