STRUCTURE PHONESTATUS (tapi.h)
La structure PHONESTATUS décrit la status actuelle d’un appareil téléphonique. Les fonctions phoneGetStatus et TSPI_phoneGetStatus retournent cette structure.
Syntaxe
typedef struct phonestatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwStatusFlags;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwRingMode;
DWORD dwRingVolume;
DWORD dwHandsetHookSwitchMode;
DWORD dwHandsetVolume;
DWORD dwHandsetGain;
DWORD dwSpeakerHookSwitchMode;
DWORD dwSpeakerVolume;
DWORD dwSpeakerGain;
DWORD dwHeadsetHookSwitchMode;
DWORD dwHeadsetVolume;
DWORD dwHeadsetGain;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwLampModesSize;
DWORD dwLampModesOffset;
DWORD dwOwnerNameSize;
DWORD dwOwnerNameOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;
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.
dwStatusFlags
Indicateurs d’état pour cet appareil téléphonique. Ce membre utilise l’une des constantes PHONESTATUSFLAGS_.
dwNumOwners
Nombre de modules d’application avec le privilège de propriétaire pour le téléphone.
dwNumMonitors
Nombre de modules d’application avec un privilège d’analyse pour le téléphone.
dwRingMode
Mode d’anneau actuel d’un appareil téléphonique.
dwRingVolume
Volume d’anneau actuel d’un appareil téléphonique. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (volume maximal).
dwHandsetHookSwitchMode
Mode d’interconnexion actuel du combiné du téléphone. Ce membre utilise l’une des constantes PHONEHOOKSWITCHMODE_.
dwHandsetVolume
Volume actuel du haut-parleur de l’appareil combiné du téléphone. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (volume maximal).
dwHandsetGain
Gain de microphone actuel de l’appareil combiné du téléphone. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (gain maximal).
dwSpeakerHookSwitchMode
Mode de connexion actuel du haut-parleur du téléphone. Ce membre utilise l’une des constantes PHONEHOOKSWITCHMODE_.
dwSpeakerVolume
Volume actuel du haut-parleur de l’appareil haut-parleur du téléphone. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (volume maximal).
dwSpeakerGain
Gain de microphone actuel de l’appareil haut-parleur du téléphone. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (gain maximal).
dwHeadsetHookSwitchMode
Mode de connexion actuel du casque du téléphone. Ce membre utilise l’une des constantes PHONEHOOKSWITCHMODE_.
dwHeadsetVolume
Volume actuel du haut-parleur de l’appareil du casque du téléphone. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (volume maximal).
dwHeadsetGain
Gain de microphone actuel de l’appareil de casque du téléphone. Il s’agit d’une valeur comprise entre 0x00000000 (silence) et 0x0000FFFF (gain maximal).
dwDisplaySize
Taille des informations d’affichage, en octets.
dwDisplayOffset
Décalage entre le début de cette structure et le champ de taille variable contenant les informations d’affichage actuelles du téléphone. La taille du champ est spécifiée par dwDisplaySize.
dwLampModesSize
Taille du tableau de modes de lampe actuel, en octets.
dwLampModesOffset
Décalage du début de cette structure vers le champ de taille variable contenant les modes de lampe actuels du téléphone. La taille du champ est spécifiée par dwLampModesSize.
dwOwnerNameSize
Taille du nom du propriétaire actuel, y compris la fin null , en octets.
dwOwnerNameOffset
Décalage entre le début de la structure et le champ de taille variable contenant le nom de l’application qui est le propriétaire actuel de l’appareil téléphonique. Le nom est le nom de l’application fourni par l’application lorsqu’elle a été appelée avec phoneInitialize ou phoneInitializeEx. Si aucun nom d’application n’a été fourni, le nom de fichier de l’application est utilisé à la place. La taille du champ est spécifiée par dwOwnerNameSize. Si le téléphone n’a actuellement aucun propriétaire, dwOwnerNameSize est égal à zéro.
dwDevSpecificSize
Taille du champ spécifique à l’appareil, 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 cette structure et le champ spécifique de l’appareil de taille variable. La taille du champ est spécifiée par dwDevSpecificSize.
dwPhoneFeatures
Indicateurs qui indiquent quelles fonctions de l’API de téléphonie peuvent être appelées sur le téléphone, compte tenu de la disponibilité de la fonctionnalité dans les fonctionnalités de l’appareil, de l’état actuel de l’appareil et de la propriété de l’appareil de l’application appelante. Un zéro indique que la fonctionnalité correspondante ne peut pas être appelée par l’application sur le téléphone dans son état actuel ; un indique que la fonctionnalité peut être appelée. Ce membre utilise une ou plusieurs constantes PHONEFEATURE_.
Remarques
Les extensions spécifiques à l’appareil doivent utiliser la zone DevSpecific (dwDevSpecificSize et dwDevSpecificOffset) de taille variable de cette structure de données.
Le membre dwPhoneFeatures est disponible uniquement pour les applications qui ouvrent l’appareil téléphonique avec une version d’API 2.0 ou ultérieure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | tapi.h |