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 數據結構的所有成員，但 TAPI 會填入 dwTotalSize 除外。 服務提供者不得覆寫 dwTotalSize 成員。

規格需求

另請參閱

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneSetButtonInfo