TSPI_phoneSetButtonInfo函数 (tspi.h)

TSPI_phoneSetButtonInfo函数设置有关指定手机上的指定按钮的信息。

语法

LONG TSPIAPI TSPI_phoneSetButtonInfo(
  DRV_REQUESTID           dwRequestID,
  HDRVPHONE               hdPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

参数

dwRequestID

异步请求的标识符。 如果函数异步完成，则服务提供程序将返回此值。

hdPhone

要为其设置按钮信息的手机的句柄。

dwButtonLampID

手机设备上的按钮。

lpButtonInfo

指向 PHONEBUTTONINFO 类型的可变大小结构的指针。 此数据结构描述模式和功能，并提供要为按钮设置的其他描述性文本。

返回值

如果函数异步完成，则返回 (正) dwRequestID 值;如果发生错误，则返回错误号。 如果函数成功，则相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。 可能的返回值如下所示：

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

注解

此函数设置手机按钮的含义和关联的描述性文本。

要求

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

另请参阅

ASYNC_COMPLETION

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneGetButtonInfo