STRUCTURE LINEDEVSTATUS (tapi.h)

Article
08/26/2023

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.