STRUCTURE LINEADDRESSSTATUS (tapi.h)
La structure LINEADDRESSSTATUS décrit l’état actuel d’une adresse. La fonction lineGetAddressStatus et la fonction TSPI_lineGetAddressStatus retournent la structure LINEADDRESSSTATUS .
Syntaxe
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;
Membres
dwTotalSize
Taille totale allouée à cette structure de données, en octets.
dwNeededSize
Taille de cette structure de données nécessaire pour contenir toutes les informations retournées, en octets.
dwUsedSize
Taille de la partie de cette structure de données qui contient des informations utiles, en octets.
dwNumInUse
Nombre de stations qui utilisent actuellement l’adresse.
dwNumActiveCalls
Nombre d’appels sur l’adresse qui se trouvent dans les états d’appel autres qu’inactifs, inactifs, onholdpendingtransfer et onholdpendingconference.
dwNumOnHoldCalls
Nombre d’appels sur l’adresse dans l’état d’entrée .
dwNumOnHoldPendCalls
Nombre d’appels sur l’adresse dans l’état onholdpendingtransfer ou onholdpendingconference .
dwAddressFeatures
Fonctions liées à l’adresse qui peuvent être appelées sur l’adresse dans son état actuel. Ce membre utilise une ou plusieurs constantes LINEADDRFEATURE_.
dwNumRingsNoAnswer
Nombre d’anneaux définis pour cette adresse avant qu’un appel non répondu ne soit considéré comme une réponse.
dwForwardNumEntries
Nombre d’entrées dans le tableau référencé par dwForwardSize et dwForwardOffset.
dwForwardSize
Taille du tableau d’informations de transfert, en octets.
dwForwardOffset
Décalage entre le début de la structure et le champ de taille variable qui décrit les informations de transfert de l’adresse. Ces informations sont un tableau d’éléments dwForwardNumEntries , de type LINEFORWARD. Les décalages des adresses du tableau sont relatifs au début de la structure LINEADDRESSSTATUS . Les décalages dwCallerAddressOffset et dwDestAddressOffset dans le champ de taille variable de type LINEFORWARD pointé par dwForwardOffset sont relatifs au début de la structure de données LINEADDRESSSTATUS (conteneur « racine »). La taille du tableau est spécifiée par dwForwardSize.
dwTerminalModesSize
Taille du tableau des modes de terminal, en octets.
dwTerminalModesOffset
Décalage entre le début de la structure et le champ d’appareil de taille variable contenant un tableau avec des entrées de taille DWORD, qui utilisent une ou plusieurs constantes LINETERMMODE_. Ce tableau est indexé par les identificateurs de terminal, dans la plage comprise entre zéro et un moins que dwNumTerminals. Chaque entrée du tableau spécifie les modes de terminal actuels pour le terminal correspondant défini avec la fonction lineSetTerminal pour cette adresse. La taille du tableau est spécifiée par dwTerminalModesSize.
dwDevSpecificSize
Taille du champ spécifique à l’appareil, en octets.
dwDevSpecificOffset
Décalage entre le début de cette structure et le champ spécifique à l’appareil de taille variable. La taille du champ est spécifiée par dwDevSpecificSize.
Remarques
Les extensions spécifiques à l’appareil doivent utiliser la zone DevSpecific (dwDevSpecificSize et dwDevSpecificOffset) de taille variable de cette structure de données.
Cette structure de données est retournée par la fonction lineGetAddressStatus . Lorsque les éléments de cette structure de données changent en conséquence des activités sur l’adresse, un message LINE_ADDRESSSTATE est envoyé à l’application. Un paramètre à ce message est l’état de l’adresse, l’une des constantes LINEADDRESSSTATE_, qui indique que l’élément d’état de cet enregistrement a changé.
Configuration requise
| En-tête | tapi.h |