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

另请参阅

PHONECAPS

TSPI_phoneGetDevCaps

TSPI_phoneSetRing