lineGetID 函式 (tapi.h)

發行項
03/05/2024

lineGetID 函式會針對與選取的行、位址或呼叫相關聯的指定裝置類別，傳回裝置標識符。

語法

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

指定開啟行裝置上的位址。位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。

hCall

呼叫的句柄。

dwSelect

指定要求的裝置標識碼是否與行、位址或單一呼叫相關聯。此參數只會使用其中一個 LINECALLSELECT_常數。

lpDeviceID

VARSTRING 類型的記憶體位置指標，其中會傳回裝置標識碼。成功完成要求時，此位置會填入裝置標識碼。傳回資訊的格式取決於裝置類別 API 用於命名裝置的方法。在呼叫 lineGetID之前，應用程式必須設定這個結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

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

lpszDeviceClass

Null 終止字串的指標，指定要求標識碼之裝置的裝置類別。有效的裝置類別字串是在 SYSTEM.INI 區段中用來識別裝置類別的字串。

傳回值

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

LINEERR_INVALLINEHANDLE、LINEERR_NOMEM、LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSELECT、LINEERR_INVALDEVICECLASS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NODEVICE、LINEERR_UNINITIALIZED。

備註

當指定行句柄時， lineGetID 函式可用來擷取線條裝置標識碼。使用 LINEMAPPER 做為裝置標識碼開啟 lineOpen 之後，這非常有用，以判斷開啟行的實際行裝置標識符。此函式也可以用來取得與通話、位址或線路相關聯的裝置類別的電話裝置或媒體裝置 (裝置標識符，例如 COM、wave、MIDI、phone、line 或 NDIS) 。然後，此標識碼可以搭配適當的 API (使用，例如手機、MIDI、wave) ，以選取與指定呼叫相關聯的對應媒體裝置。

如需裝置類別名稱，請參閱 TAPI 裝置類別。

定義裝置特定媒體模式的廠商也需要定義對應的裝置特定 (專屬) API 來管理媒體模式的裝置。為了避免不同廠商獨立指派的裝置類別名稱發生衝突，廠商應該選取可唯一識別廠商的名稱，並在該名稱之後選取媒體類型。例如：「intel/video」。