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

另請參閱

LINEAPPINFO

LINEDEVCAPS

TSPI_lineGetLineDevStatus

lineGetLineDevStatus

lineSetTerminal