LINEDEVSTATUS 結構 (tapi.h)
LINEDEVSTATUS結構描述線路裝置的目前狀態。 lineGetLineDevStatus函式和TSPI_lineGetLineDevStatus函式會傳回LINEDEVSTATUS結構。
語法
typedef struct linedevstatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwNumOpens;
DWORD dwOpenMediaModes;
DWORD dwNumActiveCalls;
DWORD dwNumOnHoldCalls;
DWORD dwNumOnHoldPendCalls;
DWORD dwLineFeatures;
DWORD dwNumCallCompletions;
DWORD dwRingMode;
DWORD dwSignalLevel;
DWORD dwBatteryLevel;
DWORD dwRoamMode;
DWORD dwDevStatusFlags;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAvailableMediaModes;
DWORD dwAppInfoSize;
DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;
成員
dwTotalSize
配置給這個資料結構的大小總計，以位元組為單位。
dwNeededSize
此資料結構的大小，需要以位元組為單位來保存所有傳回的資訊。
dwUsedSize
這個資料結構中包含實用資訊的部分大小，以位元組為單位。
dwNumOpens
行裝置上開啟的作用中數目。
dwOpenMediaModes
位陣列，指出目前開啟線路裝置的媒體類型。
dwNumActiveCalls
撥號狀態為閑置、onhold、onholdpendingtransfer和onholdpendingconference以外的行呼叫數目。
dwNumOnHoldCalls
在保留狀態的行上呼叫數目。
dwNumOnHoldPendCalls
onholdpendingtransfer或onholdpendingconfer 狀態行上的呼叫數目。
dwLineFeatures
此行目前可用的行相關函式。 此成員會使用一或多個 LINEFEATURE_常數。
dwNumCallCompletions
行上未完成的呼叫完成要求數目。
dwRingMode
線路裝置上的目前環形模式。
dwSignalLevel
這一行上連線的目前訊號層級。 這是範圍0x00000000 (最弱訊號的值，) 0x0000FFFF (最強訊號) 。
dwBatteryLevel
線路裝置硬體的目前電池計量。 這是0x00000000 (電池空白) 範圍中的值，可0x0000FFFF (電池完整) 。
dwRoamMode
目前線路裝置的漫遊模式。 此成員使用其中一個 LINEROAMMODE_常數。
dwDevStatusFlags
指出狀態資訊的旗標，例如裝置是否已鎖定。 它包含一或多個 LINEDEVSTATUSFLAGS_常數的成員。
dwTerminalModesSize
包含目前終端機模式陣列的可變大小裝置欄位大小，以位元組為單位。
dwTerminalModesOffset
從 結構的開頭到目前終端機模式陣列的位移，以位元組為單位。 此陣列是由終端機識別碼編制索引，範圍從零到 dwNumTerminals 減一。 陣列中的每個專案都會使用此行的 lineSetTerminal 函式 ，指定對應終端集的目前終端機模式。 每個專案都是 DWORD ，指定一或多個 LINETERMMODE_常數。 陣列的大小是由 dwTerminalModesSize所指定。
dwDevSpecificSize
以位元組為單位的可變大小裝置特定欄位大小。 如果裝置特定資訊是字串的指標，大小必須包含 Null 結束字元。
dwDevSpecificOffset
從結構的開頭到裝置特定欄位的位移，以位元組為單位。 欄位的大小是由 dwDevSpecificSize所指定。
dwAvailableMediaModes
指出當 dwLineFeatures 成員指出新的呼叫可能時，可以在此行裝置上建立的新呼叫上叫用的媒體類型。 如果此成員為零，表示服務提供者不知道或無法指出可用的媒體類型，在此情況下，LINEDEVCAPS中dwMediaModes成員中指出的任何或所有媒體類型都可使用。
dwAppInfoSize
陣列的大小，可識別已開啟行的應用程式，以位元組為單位。
dwAppInfoOffset
從結構的開頭位移到 LINEAPPINFO 結構的陣列。 dwNumOpens成員表示陣列中的元素數目。 陣列中的每個專案都會識別已開啟行的應用程式。 陣列的大小是由 dwAppInfoSize所指定。
備註
裝置特定的延伸模組應該使用 DevSpecific (dwDevSpecificSize 和 dwDevSpecificOffset) 此資料結構的可變大社區域。
透過dwAppInfoOffset的成員dwAvailableMediaModes僅適用于使用 API 版本為 2.0 或更新版本的應用程式開啟線路裝置。
規格需求
| 標頭 | tapi.h |