phoneSetRing 函数 (tapi.h)

项目
03/02/2024

phoneSetRing 函数使用指定的响铃模式和音量为指定的打开手机设备响铃。

语法

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

参数

hPhone

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

dwRingMode

用于拨打电话的响铃模式。此参数必须在 PHONECAPS 结构中 dwNumRingModes 成员值的零范围内。如果 dwNumRingModes 为零，则无法控制手机的响铃模式;如果 dwNumRingModes 为 1，则 dwRingMode 的值为 0 表示手机不应 (静音) 运行，而从 1 到 dwNumRingModes 的其他值是手机设备的有效响铃模式。

dwVolume

电话响铃的音量级别。这是0x00000000 (静音) 到最大音量) 0x0000FFFF (范围内的数字。此范围中卷设置的实际粒度和量化是特定于服务提供商的。 范围外 dwVolume 的值设置为区域中最近的值。

返回值

如果异步完成函数，则返回正请求标识符;如果发生错误，则返回负错误号。如果函数成功，则相应PHONE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。可能的返回值为：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_NOTOWNER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALRINGMODE、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。