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 |