lineGetDevCaps 函式 (tapi.h)

發行項
03/02/2024

lineGetDevCaps 函式會查詢指定的線路裝置，以判斷其電話語音功能。傳回的信息對於線路裝置上的所有位址都是有效的。

語法

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

參數

hLineApp

使用 TAPI 處理應用程式的註冊。

dwDeviceID

要查詢之線路裝置的標識碼。

dwAPIVersion

要使用的電話語音 API 版本號碼。高序字組包含主要版本號碼;低序字組包含次要版本號碼。此數位是由 lineNegotiateAPIVersion取得。

dwExtVersion

要使用的服務提供者特定擴充功能版本號碼。此數位是由 lineNegotiateExtVersion取得。如果未使用任何裝置特定的擴充功能，則可以保留零。否則，高序字會包含主要版本號碼;低序字組包含次要版本號碼。

lpLineDevCaps

LINEDEVCAPS 類型的可變大小結構的指標。成功完成要求時，此結構會填入線條裝置功能資訊。在呼叫 lineGetDevCaps之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

注意如果結構中的大小參數不正確，可能會覆寫數據。如需設定結構大小的詳細資訊，請參閱記憶體配置主題。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONFAILED、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALAPPHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NODRIVER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODEVICE。

備註

使用 lineGetDevCaps 之前，應用程式必須交涉要使用的 API 版本號碼，並視需要使用擴充功能版本。

API 和擴充功能版本號碼是 TAPI 和服務提供者必須在其下運作的號碼。如果版本範圍不重疊，則應用程式、API 或服務提供者版本不相容，並傳回錯誤。

此函式所傳回 LINEDEVCAPS 結構中的其中一個成員包含指派給指定行裝置的位址數目。用來參考個別地址的實際位址標識碼會從零到一個小於傳回的數位。每個位址的功能可能不同。針對每個可用的 <dwDeviceID、dwAddressID> 組合使用 lineGetAddressCaps 來判斷每個地址的確切功能。請注意，位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。