STRUCTURE LINECALLSTATUS (tapi.h)
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
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 |