STRUCTURE LINECALLSTATUS (tapi.h)

  • Article

La structure LINECALLSTATUS décrit la status actuelle d’un appel. Les informations contenues dans cette structure dépendent des fonctionnalités de l’appareil de l’adresse, de la propriété de l’appel par l’application appelante et de l’état actuel de l’appel interrogé. Les fonctions lineGetCallStatus et TSPI_lineGetCallStatus retournent la structure LINECALLSTATUS .

Syntaxe

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

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.

dwCallState

État actuel de l’appel à l’aide de l’une des constantes LINECALLSTATE_.

dwCallStateMode

L’interprétation du membre dwCallStateMode est dépendante de l’état de l’appel. Dans de nombreux cas, la valeur est égale à zéro. Le tableau suivant montre les types dwCallStateMode pour une valeur dwCallState donnée .

dwCallState Signification
LINECALLSTATE_BUSY

constantes LINEBUSYMODE_
LINECALLSTATE_CONNECTED

constantes LINECONNECTEDMODE_
LINECALLSTATE_DIALTONE

constantes LINEDIALTONEMODE_
LINECALLSTATE_DISCONNECTED

constantes LINEDISCONNECTMODE_
LINECALLSTATE_OFFERING

constantes LINEOFFERINGMODE_
LINECALLSTATE_SPECIALINFO

constantes LINESPECIALINFO_

dwCallPrivilege

Privilège de l’application pour cet appel. Ce membre utilise une ou plusieurs constantes LINECALLPRIVILEGE_.

dwCallFeatures

Indicateurs qui indiquent les fonctions de l’API de téléphonie qui peuvent être appelées sur l’appel, compte tenu de la disponibilité de la fonctionnalité dans les fonctionnalités de l’appareil, de l’état actuel de l’appel et de la propriété de l’appel de l’application appelante. Un zéro indique que la fonctionnalité correspondante ne peut pas être appelée par l’application sur l’appel dans son état actuel ; un indique que la fonctionnalité peut être appelée. Ce membre utilise des constantes LINECALLFEATURE_.

dwDevSpecificSize

Taille du champ spécifique à l’appareil, en octets.

dwDevSpecificOffset

Décalage entre le début de la structure et le champ spécifique à l’appareil de taille variable. La taille du champ est spécifiée par dwDevSpecificOffset.

dwCallFeatures2

Indique que des fonctions supplémentaires peuvent être appelées sur l’appel, compte tenu de la disponibilité de la fonctionnalité dans les fonctionnalités de l’appareil, de l’état actuel de l’appel et de la propriété de l’appel de l’application appelante. Extension du membre dwCallFeatures . Ce membre utilise des constantes LINECALLFEATURE2_.

tStateEntryTime

Heure universelle coordonnée à laquelle l’état actuel de l’appel a été entré.

tStateEntryTime[8]

Heure universelle coordonnée à laquelle l’état actuel de l’appel a été entré.

Remarques

Les extensions spécifiques à l’appareil doivent utiliser la zone DevSpecific (dwDevSpecificSize et dwDevSpecificOffset) de taille variable de cette structure de données.

L’application reçoit un message LINE_CALLSTATE chaque fois que l’état de l’appel d’un appel change. Ce message fournit uniquement le nouvel état de l’appel. Des status supplémentaires sur un appel sont disponibles avec lineGetCallStatus.

Les membres dwCallFeatures2 et tStateEntryTime sont disponibles uniquement pour les applications qui ouvrent l’appareil de ligne avec une version d’API 2.0 ou ultérieure.

Configuration requise

Condition requise Valeur
En-tête tapi.h

Voir aussi

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus