Struttura LINEADDRESSSTATUS (tapi.h)

Articolo
03/08/2023

La struttura LINEADDRESSSTATUS descrive lo stato corrente di un indirizzo. La funzione lineGetAddressStatus e la funzione TSPI_lineGetAddressStatus restituiscono la struttura LINEADDRESSSTATUS .

Sintassi

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;

Members

dwTotalSize

Dimensioni totali assegnate a questa struttura di dati, in byte.

dwNeededSize

Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.

dwUsedSize

Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.

dwNumInUse

Numero di stazioni attualmente in uso.

dwNumActiveCalls

Numero di chiamate sull'indirizzo che si trovano in stati di chiamata diversi da inattività, onhold, onholdpendingtransfer e onholdpendingconference.

dwNumOnHoldCalls

Numero di chiamate sull'indirizzo nello stato onhold .

dwNumOnHoldPendCalls

Numero di chiamate sull'indirizzo nello stato onholdpendingtransfer o onholdpendingconference .

dwAddressFeatures

Funzioni correlate agli indirizzi che possono essere richiamate sull'indirizzo nello stato corrente. Questo membro usa una o più costanti LINEADDRFEATURE_.

dwNumRingsNoAnswer

Numero di anelli impostati per questo indirizzo prima che una chiamata senza risposta sia considerata nessuna risposta.

dwForwardNumEntries

Numero di voci nella matrice a cui fa riferimento dwForwardSize e dwForwardOffset.

dwForwardSize

Dimensioni della matrice di informazioni di inoltro, in byte.

dwForwardOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che descrive le informazioni sull'inoltro dell'indirizzo. Queste informazioni sono una matrice di elementi dwForwardNumEntries , di tipo LINEFORWARD. Gli offset degli indirizzi nella matrice sono relativi all'inizio della struttura LINEADDRESSSTATUS . Gli offset dwCallerAddressOffset e dwDestAddressOffset nel campo variabile di tipo LINEFORWARD puntato da dwForwardOffset sono relativi all'inizio della struttura di dati LINEADDRESSSTATUS (contenitore "radice"). Le dimensioni della matrice sono specificate da dwForwardSize.

dwTerminalModesSize

Dimensioni della matrice delle modalità terminale, in byte.

dwTerminalModesOffset

Offset dall'inizio della struttura al campo dispositivo di dimensioni variabile contenente una matrice con voci di dimensioni DWORD, che usano una o più costanti LINETERMMODE_. Questa matrice viene indicizzata dagli identificatori del terminale, nell'intervallo compreso tra zero e uno minore di dwNumTerminals. Ogni voce della matrice specifica le modalità del terminale correnti per il set di terminale corrispondente con la funzione lineSetTerminal per questo indirizzo. Le dimensioni della matrice sono specificate da dwTerminalModesSize.

dwDevSpecificSize

Dimensioni del campo specifico del dispositivo, in byte.

dwDevSpecificOffset

Offset dall'inizio di questa struttura al campo specifico del dispositivo di dimensioni variabile. La dimensione del campo è specificata da dwDevSpecificSize.

Commenti

Le estensioni specifiche del dispositivo devono usare l'area devSpecific (dwDevSpecificSize e dwDevSpecificOffset) variamente ridimensionata di questa struttura di dati.

Questa struttura di dati viene restituita dalla funzione lineGetAddressStatus . Quando gli elementi in questa struttura di dati cambiano come conseguenza delle attività sull'indirizzo, viene inviato un messaggio LINE_ADDRESSSTATE all'applicazione. Un parametro per questo messaggio è lo stato dell'indirizzo, una delle costanti LINEADDRESSSTATE_, che indica che l'elemento di stato di questo record è cambiato.