TSPI_phoneGetButtonInfo 函数 (tspi.h)

TSPI_phoneGetButtonInfo 函数返回有关指定按钮的信息。

语法

LONG TSPIAPI TSPI_phoneGetButtonInfo(
  HDRVPHONE         hdPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

参数

hdPhone

要查询的电话的句柄。

dwButtonLampID

电话设备上的按钮。

lpButtonInfo

指向内存的指针，服务提供程序在其中写入 类型为 PHONEBUTTONINFO 的可变大小结构。 此数据结构描述模式和功能，并提供与按钮对应的其他描述性文本。 在调用 TSPI_phoneGetButtonInfo 之前，应用程序会设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：

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

注解

如果服务提供商无法访问包含按钮信息的内存， TSPI_phoneGetButtonInfo 函数将返回PHONEERR_NOMEM值。

服务提供商填充 PHONEBUTTONINFO 数据结构的所有成员， dwTotalSize 除外，该成员由 TAPI 填充。 服务提供商不得覆盖 dwTotalSize 成员。

要求

要求	值
目标平台	Windows
标头	tspi.h

另请参阅

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneSetButtonInfo