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