TSPI_phoneSetStatusMessages 函数 (tspi.h)
TSPI_phoneSetStatusMessages 函数会导致服务提供商筛选任何应用程序当前不感兴趣的状态消息。
语法
LONG TSPIAPI TSPI_phoneSetStatusMessages(
HDRVPHONE hdPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
参数
hdPhone
要设置其状态更改监视筛选器的手机的不透明句柄。
dwPhoneStates
指定 TAPI 要接收通知消息的电话状态更改和事件的集合的标志。 此参数可以具有零个、一个或多个 PHONESTATE_常量。
dwButtonModes
指定 TAPI 要接收通知消息的电话按钮模式集的标志。 如果 dwButtonModes 为零，则忽略 dwButtonStates 。 此参数可以具有零个、一个或多个 PHONEBUTTONMODE_常量。 如果 dwButtonModes 至少设置了其中一个标志， 则 dwButtonStates 还必须至少设置了一个位：
dwButtonStates
此参数指定 TAPI 希望接收通知消息的电话按钮状态更改集， PHONEBUTTONSTATE_常量之一。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALBUTTONMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALBUTTONSTATE、PHONEERR_OPERATIONUNAVAIL。
注解
TAPI 定义一些消息，用于通知应用程序手机上发生的事件。 所有应用程序都感兴趣的所有更改消息集可能比可能的消息集要小得多。 此过程允许 TAPI 告知服务提供商要传递的消息集减少。 服务提供程序在指定的集中传递它支持的所有消息。 允许提供更多 (TAPI) 会将其筛选掉，但出于性能原因，不建议这样做。 如果 TAPI 请求传递不是由提供程序生成的特定消息类型，则提供程序仍接受该请求，但不会生成该消息。 默认情况下禁用除PHONESTATE_REINIT之外的所有手机状态消息。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |