Skip to content

Latest commit

 

History

History
88 lines (66 loc) · 2.9 KB

nf-tapi-phonesetvolume.md

File metadata and controls

88 lines (66 loc) · 2.9 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:tapi.phoneSetVolume
phoneSetVolume function (tapi.h)
The phoneSetVolume function sets the volume of the speaker component of the specified hookswitch device to the specified level.
_tapi2_phonesetvolume
phoneSetVolume
phoneSetVolume function [TAPI 2.2]
tapi/phoneSetVolume
tapi2.phonesetvolume
tapi2\phonesetvolume.htm
tapi3
114aba48-f058-47c9-9ee7-493bd758b8a6
12/05/2018
_tapi2_phonesetvolume, phoneSetVolume, phoneSetVolume function [TAPI 2.2], tapi/phoneSetVolume, tapi2.phonesetvolume
tapi.h
Windows
Tapi32.lib
Tapi32.dll
Windows
19H1
phoneSetVolume
tapi/phoneSetVolume
c++
APIRef
kbSyntax
DllExport
Tapi32.dll
phoneSetVolume

phoneSetVolume function

-description

The phoneSetVolume function sets the volume of the speaker component of the specified hookswitch device to the specified level.

-parameters

-param hPhone

Handle to the open phone device. The application must be the owner of the phone.

-param dwHookSwitchDev

Hookswitch device whose speaker's volume is to be set, one of the PHONEHOOKSWITCHDEV_ Constants.

-param dwVolume

New 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.

-returns

Returns a positive request identifier if the function is completed asynchronously or a negative error number if an error occurs. The dwParam2 parameter of the corresponding PHONE_REPLY message is zero if the function succeeds or it is a negative error number if an error occurs. Possible return values are:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

-see-also

PHONE_REPLY

Supplementary Phone Service Functions

TAPI 2.2 Reference Overview