phoneGetDevCaps 函式 (tapi.h)
phoneGetDevCaps函式會查詢指定的電話裝置，以判斷其電話語音功能。
語法
LONG phoneGetDevCaps(
HPHONEAPP hPhoneApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
參數
hPhoneApp
使用 TAPI 處理應用程式的註冊。
dwDeviceID
要查詢之電話裝置的識別碼。
dwAPIVersion
要使用的電話語音 API 版本號碼。 高序字組包含主要版本號碼;低序字組包含次要版本號碼。 此號碼是透過 函式 phoneNegotiateAPIVersion取得。
dwExtVersion
要使用的服務提供者特定擴充功能版本號碼。 此號碼是透過 函式 phoneNegotiateExtVersion取得。 如果未使用任何裝置特定的擴充功能，則可以保留零。 否則，高序字會包含主要版本號碼;低序字組包含次要版本號碼。
lpPhoneCaps
PHONECAPS類型的可變大小結構的指標。 成功完成要求時，此結構會填入手機裝置功能資訊。
傳回值
如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：
PHONEERR_INVALAPPHANDLE、PHONEERR_INVALPOINTER、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONFAILED、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_NOMEM、PHONEERR_STRUCTURETOOSMALL、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_UNINITIALIZED、PHONEERR_NODEVICE。
備註
使用 phoneGetDevCaps之前，應用程式必須交涉 TAPI 版本號碼才能使用， (請參閱 phoneNegotiateAPIVersion) ，並選擇性地使用擴充功能版本， (請參閱 phoneNegotiateExtVersion) 。
TAPI 和擴充功能版本號碼是 TAPI、電話語音 DLL 和服務提供者必須運作的號碼。 如果版本範圍不重迭，則應用程式和 API 或服務提供者版本不相容，並傳回錯誤。
規格需求
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |