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 |