STRUCTURE LINEDEVSTATUS (tapi.h)
La structure LINEDEVSTATUS décrit la status actuelle d’un appareil de ligne. La fonction lineGetLineDevStatus et la fonction TSPI_lineGetLineDevStatus retournent la structure LINEDEVSTATUS .
Syntaxe
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;
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.
dwNumOpens
Nombre d’ouvertures actives sur l’appareil de ligne.
dwOpenMediaModes
Tableau de bits qui indique pour quels types de supports l’appareil de ligne est actuellement ouvert.
dwNumActiveCalls
Nombre d’appels sur la ligne dans des états d’appel autres que inactive, onhold, onholdpendingtransfer et onholdpendingconference.
dwNumOnHoldCalls
Nombre d’appels sur la ligne dans l’état d’attente .
dwNumOnHoldPendCalls
Nombre d’appels sur la ligne dans l’état onholdpendingtransfer ou onholdpendingconference .
dwLineFeatures
Fonctions liées aux lignes actuellement disponibles sur cette ligne. Ce membre utilise une ou plusieurs constantes LINEFEATURE_.
dwNumCallCompletions
Nombre de demandes d’achèvement d’appel en attente sur la ligne.
dwRingMode
Mode d’anneau actuel sur l’appareil de ligne.
dwSignalLevel
Niveau de signal actuel de la connexion sur la ligne. Il s’agit d’une valeur comprise dans la plage 0x00000000 (signal le plus faible) à 0x0000FFFF (signal le plus fort).
dwBatteryLevel
Niveau de batterie actuel du matériel de l’appareil de ligne. Il s’agit d’une valeur comprise dans la plage 0x00000000 (batterie vide) à 0x0000FFFF (batterie pleine).
dwRoamMode
Mode itinérant actuel de l’appareil de ligne. Ce membre utilise l’une des constantes LINEROAMMODE_.
dwDevStatusFlags
Indicateurs qui indiquent status informations, telles que si l’appareil est verrouillé. Il se compose d’un ou plusieurs membres de LINEDEVSTATUSFLAGS_ constantes.
dwTerminalModesSize
Taille du champ d’appareil de taille variable contenant un tableau de modes terminal actuels, en octets.
dwTerminalModesOffset
Décalage du début de la structure vers un tableau de modes terminal actuels, en octets. Ce tableau est indexé par id terminal, dans la plage de zéro à dwNumTerminals moins un. Chaque entrée du tableau spécifie les modes de terminal actuels pour le jeu de terminaux correspondant à l’aide de la fonction lineSetTerminal pour cette ligne. Chaque entrée est un DWORD qui spécifie une ou plusieurs constantes LINETERMMODE_. La taille du tableau est spécifiée par dwTerminalModesSize.
dwDevSpecificSize
Taille du champ spécifique à l’appareil de taille variable, en octets. Si les informations spécifiques à l’appareil sont un pointeur vers une chaîne, la taille doit inclure la terminaison null .
dwDevSpecificOffset
Décalage entre le début de la structure et le champ spécifique à l’appareil, en octets. La taille du champ est spécifiée par dwDevSpecificSize.
dwAvailableMediaModes
Indique les types de médias qui peuvent être appelés sur les nouveaux appels créés sur cet appareil de ligne, lorsque le membre dwLineFeatures indique que de nouveaux appels sont possibles. Si ce membre est égal à zéro, cela indique que le fournisseur de services ne sait pas ou ne peut pas indiquer quels types de médias sont disponibles, auquel cas tout ou partie des types de médias indiqués dans le membre dwMediaModes dans LINEDEVCAPS peuvent être disponibles.
dwAppInfoSize
Taille du tableau qui identifie les applications dont la ligne est ouverte, en octets.
dwAppInfoOffset
Décalage du début de la structure vers un tableau de structures LINEAPPINFO . Le membre dwNumOpens indique le nombre d’éléments dans le tableau. Chaque élément du tableau identifie une application dont la ligne est ouverte. La taille du tableau est spécifiée par dwAppInfoSize.
Remarques
Les extensions spécifiques à l’appareil doivent utiliser la zone DevSpecific (dwDevSpecificSize et dwDevSpecificOffset) de taille variable de cette structure de données.
Les membres dwAvailableMediaModes via dwAppInfoOffset sont disponibles uniquement pour les applications qui ouvrent l’appareil de ligne avec une version d’API 2.0 ou ultérieure.
Configuration requise
| En-tête | tapi.h |