通过

phoneSetGain 函数 (tapi.h)

  • 项目

phoneSetGain 函数将指定挂钩开关设备的麦克风增益设置为指定的增益级别。

语法

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

参数

hPhone

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

dwHookSwitchDev

要设置其麦克风增益的挂钩开关设备。 此参数使用一个且只使用一个 PHONEHOOKSWITCHDEV_常量。

dwGain

指向包含设备的新增益设置的 DWORD 的指针。 dwGain 参数指定挂钩开关设备的增益级别。 这是0x00000000 (静音) 到最大音量) 0x0000FFFF (范围内的数字。 此范围内增益设置的实际粒度和量化是特定于服务提供商的。 范围外 dwGain 的值设置为区域中最接近的值。

返回值

如果异步完成函数，则返回正请求标识符;如果发生错误，则返回负错误号。 如果函数成功，则相应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 参考概述