TSPI_phoneGetStatus 函数 (tspi.h)
TSPI_phoneGetStatus函数查询指定的打开电话设备的总体状态。
语法
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
参数
hdPhone
要查询的电话的句柄。
lpPhoneStatus
指向 PHONESTATUS 类型的可变大小数据结构的指针，服务提供商在其中写入有关手机状态的信息。 在调用 TSPI_phoneGetStatus 之前，应用程序设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
注解
下表指示 TAPI 填充了 PHONESTATUS 数据结构的哪些成员，以及服务提供商填充了哪些成员。 服务提供商不得覆盖 TAPI 填充的值。
| 成员 | Tapi | 服务提供商 |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI 可以使用此函数来确定打开的手机设备的当前状态。 状态信息描述有关手机设备的挂钩开关设备、响铃器、音量、显示器和打开电话灯的信息。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |