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 |