TSPI_phoneSetGain 函数 (tspi.h)
TSPI_phoneSetGain函数将指定挂钩开关设备的麦克风增益设置为指定的增益级别。
语法
LONG TSPIAPI TSPI_phoneSetGain(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
参数
dwRequestID
异步请求的标识符。
hdPhone
包含要设置其增益的挂钩开关设备的手机的句柄。
dwHookSwitchDev
要设置其麦克风增益的挂钩开关设备。 此参数只使用一个 PHONEHOOKSWITCHDEV_常量。
dwGain
包含设备所需新增益设置的 DWORD 大小位置。 这是一个数字，范围从0x00000000 (静音) 到0x0000FFFF (最大音量) 。 此范围内增益设置的实际粒度和量化是特定于服务提供程序的。 如果 dwGain 的值在范围外，则由 TAPI 固定为最接近的范围内的值。
返回值
如果发生错误，则返回 dwRequestID 或错误号。 如果函数成功，则相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。 可能的返回值如下所示：
PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOMEM。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |