TSPI_phoneSetRing 函数 (tspi.h)

项目
08/26/2023

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

语法

LONG TSPIAPI TSPI_phoneSetRing(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwRingMode,
  DWORD         dwVolume
);

参数

dwRequestID

异步请求的标识符。

hdPhone

要运行的电话的句柄。

dwRingMode

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

dwVolume

要运行手机的音量级别。这是从0x00000000 (静音) 到最大音量) 0x0000FFFF (范围内的数字。此范围中卷设置的实际粒度和量化是特定于服务提供商的。 TAPI 将 dwVolume 的值限制为范围中最近的值。

返回值

如果发生错误，则返回 dwRequestID 或错误号。如果函数成功，则相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。可能的返回值如下所示：

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