LINEADDRESSSTATUS 結構 (tapi.h)

發行項
03/05/2024

LINEADDRESSSTATUS 結構描述位址的目前狀態。 lineGetAddressStatus 函式和TSPI_lineGetAddressStatus函式會傳回 LINEADDRESSSTATUS 結構。

語法

typedef struct lineaddressstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumInUse;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwAddressFeatures;
  DWORD dwNumRingsNoAnswer;
  DWORD dwForwardNumEntries;
  DWORD dwForwardSize;
  DWORD dwForwardOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;

成員

dwTotalSize

配置給這個數據結構的大小總計，以位元組為單位。

dwNeededSize

此數據結構的大小，需要以位元組為單位來保存所有傳回的資訊。

dwUsedSize

包含實用資訊的這個數據結構部分大小，以位元組為單位。

dwNumInUse

目前使用位址的月臺數目。

dwNumActiveCalls

處於閑置、onhold、onholdpendingtransfer 和 onholdpendingconference 以外之地址的呼叫數目。

dwNumOnHoldCalls

在保留狀態的位址上呼叫數目。

dwNumOnHoldPendCalls

onholdpendingtransfer 或 onholdpendingconference 狀態之地址的呼叫數目。

dwAddressFeatures

地址相關函式，可在其目前狀態的位址上叫用。這個成員會使用一或多個 LINEADDRFEATURE_常數。

dwNumRingsNoAnswer

在未接聽的呼叫被視為沒有答案之前，為此位址設定的通道數目。

dwForwardNumEntries

dwForwardSize 和 dwForwardOffset 所參照陣列中的項目數。

dwForwardSize

轉送資訊陣列的大小，以位元組為單位。

dwForwardOffset

從結構的開頭位移至描述位址轉送資訊的可變大小欄位。這項資訊是LINEFORWARD類型的 dwForwardNumEntries 元素陣列。數位中位址的位移相對於 LINEADDRESSSTATUS 結構的開頭。 dwForwardOffset 所指向之 LINEFORWARD 類型的位移 dwCallerAddressOffset 和 dwDestAddressOffset 會相對於 “root” 容器) 之 LINEADDRESSSTATUS 數據 (結構的開頭。陣列的大小是由 dwForwardSize 所指定。

dwTerminalModesSize

終端機模式陣列的大小，以位元組為單位。

dwTerminalModesOffset

從結構的開頭位移至包含具有 DWORD 大小項目的數位的可變大小裝置欄位，這些陣列使用一或多個 LINETERMMODE_常數。此陣列是由終端機標識碼編製索引，範圍從零到小於 dwNumTerminals。數位中的每個項目都會為此位址指定對應終端機集的目前終端機模式，以及 lineSetTerminal函式。陣列的大小是由 dwTerminalModesSize 所指定。

dwDevSpecificSize

裝置特定欄位的大小，以位元組為單位。

dwDevSpecificOffset

從這個結構的開頭到可變大小的裝置特定欄位的位移。欄位的大小是由 dwDevSpecificSize 所指定。