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。

備註

此函式會設定手機按鈕的意義和相關聯的描述性文字。

規格需求

另請參閱

ASYNC_COMPLETION

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneGetButtonInfo