phoneSetVolume
The phoneSetVolume
sets the volume of the speaker component of the specified hookswitch device to
the specified level.
LONG phoneSetVolume(
HPHONE hPhone, |
|
DWORD dwHookSwitchDev, |
|
DWORD dwVolume |
|
); |
|
Parameters
hPhone
A handle to
the open phone device. The application must be the owner of the phone.
dwHookSwitchDev
The
hookswitch device whose speaker's volume is to be set.
PHONEHOOKSWITCHDEV_HANDSET
The phone's
handset.
PHONEHOOKSWITCHDEV_SPEAKER
The phone's
speakerphone or adjunct.
PHONEHOOKSWITCHDEV_HEADSET
The phone's
headset.
dwVolume
The current
volume setting of the device. The dwVolume parameter specifies the
volume level of the hookswitch device. This is a number in the range 0x00000000
(silence) to 0x0000FFFF (maximum volume). The actual granularity and
quantization of volume settings in this range are service-provider specific. A
value for dwVolume that is out of range is set to the nearest value in
the range.
Return Values
Returns a
positive request ID if the function will be completed asynchronously or a
negative error number if an error has occurred. The dwParam2 parameter
of the corresponding PHONE_REPLY message is zero if the function is successful
or it is a negative error number if an error has occurred. Possible return
values are:
PHONEERR_INVALPHONEHANDLE,
PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE,
PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED,
PHONEERR_OPERATIONUNAVAIL.
See Also