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

在通話狀態中，閑置、內部保留、onholdpendingtransfer，以及 onholdpendingconference以外的通話數目。

dwNumOnHoldCalls

處於 onhold 狀態的行上呼叫數目。

dwNumOnHoldPendCalls

onholddingtransfer 或 onholdpendingconference 狀態行上的呼叫數目。

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 成員表示可以進行新的呼叫時。如果這個成員為零，則表示服務提供者不知道或無法指出可用的媒體類型，在此情況下，dwMediaModes 成員中 LINEDEVCAPS 中指出的任何或所有媒體類型都可以使用。

dwAppInfoSize

陣列的大小，可識別已開啟行的應用程式，以位元組為單位。

dwAppInfoOffset

從結構的開頭位移為 LINEAPPINFO 結構的陣列。 dwNumOpens 成員表示陣列中的元素數目。陣列中的每個項目都會識別已開啟行的應用程式。陣列的大小是由 dwAppInfoSize所指定。