phoneGetDevCapsA 函式（tapi.h）

phoneGetDevCaps 函式會查詢指定的電話裝置，以判斷其電話語音功能。

語法

LONG phoneGetDevCapsA(
  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。