phoneSetVolume 函数 (tapi.h)

phoneSetVolume 函数将指定挂钩开关设备的扬声器组件的音量设置为指定级别。

语法

LONG phoneSetVolume(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwVolume
);

参数

hPhone

打开的手机设备的句柄。 应用程序必须是电话的所有者。

dwHookSwitchDev

要设置扬声器音量的 Hookswitch 设备, PHONEHOOKSWITCHDEV_常量之一。

dwVolume

设备的新卷设置。 dwVolume 参数指定 hookswitch 设备的卷级别。 这是) 0x00000000 (最大音量) 0x0000FFFF (范围内的数字。 此范围内卷设置的实际粒度和量化是特定于服务提供程序的。 将 dwVolume 的值设置为范围中最接近的值。

返回值

如果函数以异步方式完成,则返回一个正请求标识符;如果发生错误,则返回负错误号。 如果函数成功,则相应PHONE_REPLY消息的 dwParam2 参数为零;如果发生错误,则为负错误号。 可能的返回值为:

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_NOTOWNER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。

要求

要求
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

另请参阅

PHONE_REPLY

补充电话服务函数

TAPI 2.2 参考概述