lineGetDevCapsW 函式（tapi.h）

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

語法

LONG lineGetDevCapsW(
  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使用 lineGetAddressCaps，dwAddressID> 組合來判斷每個位址的確切功能。請注意，位址標識符會永久與地址相關聯;標識碼在操作系統升級之間維持不變。

注意

tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetDevCaps 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。