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 成員。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |