TSPI 裝置類別
裝置類別是一組相關的實體裝置或設備磁碟機,應用程式會透過這些裝置或設備磁碟機來傳送和接收呼叫的資訊或資料。 每個裝置類別都有一個可唯一識別 類別的 裝置類別名稱 ,並提供可用來開啟和與 類別中裝置通訊之程式設計介面和命令的相關資訊。
Telephony 應用程式程式設計介面 (TAPI) 將裝置從一或多個裝置類別關聯至每一行或電話裝置。 您可以使用 lineGetID 或 phoneGetID 函式來擷取裝置的裝置識別碼,以存取其中一個裝置。 您提供裝置類別名稱,而且函式會傳回您需要開啟和存取裝置的特定埠名稱、裝置名稱、裝置控制碼或裝置識別碼。 傳回信息的格式取決於裝置類別,本節會說明。
您也可以搭配 lineConfigDialog 和 phoneConfigDialog 函式使用裝置類別名稱,讓使用者設定指定裝置的組態選項;使用 lineGetIcon 和 phoneGetIcon 函式來擷取圖示來代表指定的裝置;和 搭配 lineGetDevConfig 和 lineSetDevConfig 函式,直接擷取並設定指定裝置的組態選項。
以下是預設裝置類別名稱。
裝置類別名稱 | Description |
---|---|
通訊 | 通訊埠 |
comm/datamodem | 透過通訊埠的數據機 |
comm/datamodem/portname | 數據機所連接的裝置名稱 |
wave/in | 僅) 輸入的波浪音訊裝置 ( |
wave/out | 僅) 波音訊裝置 (輸出 |
wave/in/out | 波浪音訊裝置,全雙工 |
midi/in | 僅限 MIDI 排序器 (輸入) |
midi/out | 僅限 MIDI 排序器 (輸出) |
tapi/line | 線路裝置 |
tapi/phone | 電話裝置 |
Ndis | 網路裝置 |
tapi/terminal | 終端機裝置 |
這些名稱不區分大小寫,因此您可以使用大寫和小寫字母的任何組合。
指定的系統上可能會提供其他裝置類別和裝置類別名稱。 一般而言,如果裝置不屬於其中一個預設裝置類別,製造商通常會定義新的裝置類別,並指派唯一的裝置類別名稱。 您必須檢查裝置的檔,以判斷有哪些額外的裝置類別可供其使用。 不過請注意,雖然裝置類別和媒體類型相關,但它們並不相同。 媒體類型描述呼叫上的資訊格式,而裝置類別會定義用來管理該資訊的程式設計介面。 因此,即使製造商定義新的媒體類型,製造商也必須定義新的裝置類別來支援模式,可能不是真的。
與 lineSetDevConfig 和 lineGetDevConfig 函式搭配使用的組態資料格式也取決於裝置類別。 一般而言,您可以使用 lineGetDevConfig 來儲存目前裝置組態資料的複本,然後稍後使用 lineSetDevConfig 搭配儲存的組態資料,將裝置組態還原到先前的狀態。 這是暫時變更設定的便利方式,不需要使用者手動將它還原到先前的狀態。 因為裝置組態資料的確切格式可能會與每個服務提供者不同,所以請勿使用 lineSetDevConfig 和 lineGetDevConfig 直接操作裝置設定資料。 某些格式僅供資訊使用。