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 |