TSPI_phoneGetRing 函数 (tspi.h)
TSPI_phoneGetRing 函数使应用程序能够将指定的打开手机设备查询为其当前响铃模式。
语法
LONG TSPIAPI TSPI_phoneGetRing(
HDRVPHONE hdPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
参数
hdPhone
要查询其响铃模式的手机的句柄。
lpdwRingMode
电话响铃的响铃模式。 零表示电话未响铃。
lpdwVolume
电话响铃的音量级别。 这是一个数字,范围从0x00000000 (静音) 到0x0000FFFF (最大音量) 。 此范围内卷设置的实际粒度和量化是特定于服务提供商的。
返回值
如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:
PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL。
注解
服务提供商定义与每个手机的响铃模式对应的实际听觉响铃模式。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |