TSPI_phoneGetDevCaps函式 (tspi.h)
TSPI_phoneGetDevCaps函式會查詢指定的電話裝置，以判斷其電話語音功能。
語法
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
參數
dwDeviceID
要查詢的電話裝置。
dwTSPIVersion
交涉的 TSPI 版本號碼。 這個裝置會透過 TSPI_phoneNegotiateTSPIVersion 函式來交涉此值。
dwExtVersion
交涉的擴充功能版本號碼。 這個裝置會透過 TSPI_phoneNegotiateExtVersion 函式來交涉此值。
lpPhoneCaps
服務提供者寫入 PHONECAPS 類型的可變大小結構之內存指標。 成功完成要求時，此結構會填入電話裝置功能資訊。 在呼叫 TSPI_phoneGetDevCaps之前，應用程式會設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回資訊的記憶體數量。
傳回值
如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NODRIVER、PHONEERR_OPERATIONUNAVAIL PHONEERR_NOMEM。
備註
服務提供者會填入 PHONEBUTTONINFO 數據結構的所有成員，但 TAPI 填入的 dwTotalSize 除外。 服務提供者不得覆寫 dwTotalSize 成員。
如果 dwExtVersion 為零，則不會要求任何延伸模組資訊。 如果是非零值，它會保留已經與TSPI_phoneNegotiateExtVersion函式交涉給此裝置 的值 。 服務提供者會根據指定的擴充版本填入裝置和廠商特定的擴充資訊。
服務提供者從 TSPI_phoneGetDevCaps 函式傳回之後，TAPI 會設定 PHONECAPS 結構的 dwPhoneStates 成員，如下所示：
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |