STRUCTURE PHONESTATUS (tapi.h)

Article
08/26/2023

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.