PHONECAPS, structure (tapi.h)

Article
08/26/2023

La structure PHONECAPS décrit les fonctionnalités d’un appareil téléphonique. Les fonctions phoneGetDevCaps et TSPI_phoneGetDevCaps retournent cette structure.

Syntaxe

typedef struct phonecaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwProviderInfoSize;
  DWORD dwProviderInfoOffset;
  DWORD dwPhoneInfoSize;
  DWORD dwPhoneInfoOffset;
  DWORD dwPermanentPhoneID;
  DWORD dwPhoneNameSize;
  DWORD dwPhoneNameOffset;
  DWORD dwStringFormat;
  DWORD dwPhoneStates;
  DWORD dwHookSwitchDevs;
  DWORD dwHandsetHookSwitchModes;
  DWORD dwSpeakerHookSwitchModes;
  DWORD dwHeadsetHookSwitchModes;
  DWORD dwVolumeFlags;
  DWORD dwGainFlags;
  DWORD dwDisplayNumRows;
  DWORD dwDisplayNumColumns;
  DWORD dwNumRingModes;
  DWORD dwNumButtonLamps;
  DWORD dwButtonModesSize;
  DWORD dwButtonModesOffset;
  DWORD dwButtonFunctionsSize;
  DWORD dwButtonFunctionsOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwNumSetData;
  DWORD dwSetDataSize;
  DWORD dwSetDataOffset;
  DWORD dwNumGetData;
  DWORD dwGetDataSize;
  DWORD dwGetDataOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwPhoneFeatures;
  DWORD dwSettableHandsetHookSwitchModes;
  DWORD dwSettableSpeakerHookSwitchModes;
  DWORD dwSettableHeadsetHookSwitchModes;
  DWORD dwMonitoredHandsetHookSwitchModes;
  DWORD dwMonitoredSpeakerHookSwitchModes;
  DWORD dwMonitoredHeadsetHookSwitchModes;
  GUID  PermanentPhoneGuid;
} PHONECAPS, *LPPHONECAPS;

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.

dwProviderInfoSize

Taille des informations spécifiques au fournisseur, en octets. Si les informations spécifiques au fournisseur sont un pointeur vers une chaîne, la taille doit inclure la marque de fin Null .

dwProviderInfoOffset

Décalage du début de la structure vers le champ de taille variable contenant des informations spécifiques au fournisseur de services.

Ce membre fournit des informations sur le matériel et/ou le logiciel du fournisseur, telles que le nom du fournisseur et les numéros de version du matériel et des logiciels. Ces informations peuvent être utiles lorsqu’un utilisateur a besoin d’appeler le service clientèle avec des problèmes concernant le fournisseur. La taille du champ est spécifiée par dwProviderInfoSize.

dwPhoneInfoSize

Taille des informations spécifiques au téléphone, en octets. Si les informations spécifiques au téléphone sont un pointeur vers une chaîne, la taille doit inclure la marque de fin Null .

dwPhoneInfoOffset

Décalage du début de la structure vers le champ d’appareil de taille variable contenant des informations spécifiques au téléphone.

Ce membre fournit des informations sur l’appareil téléphonique attaché, telles que le fabricant de l’appareil téléphonique, le nom du modèle, la version du logiciel, etc. Ces informations peuvent être utiles lorsqu’un utilisateur a besoin d’appeler le service clientèle avec des problèmes concernant le téléphone. La taille du champ est spécifiée par dwPhoneInfoSize.

dwPermanentPhoneID

Identificateur permanent par lequel l’appareil téléphonique est connu dans la configuration du système.

dwPhoneNameSize

Taille du nom configurable pour le téléphone, y compris la marque de fin Null , en octets.

dwPhoneNameOffset

Décalage du début de la structure vers le champ d’appareil de taille variable contenant un nom configurable par l’utilisateur pour cet appareil téléphonique. Ce nom peut être configuré par l’utilisateur lors de la configuration du fournisseur de services de l’appareil téléphonique et est fourni pour la commodité de l’utilisateur. La taille du champ est spécifiée par dwPhoneNameSize.

dwStringFormat

Format de chaîne à utiliser avec cet appareil téléphonique. Ce membre utilise l’une des constantes STRINGFORMAT_.

dwPhoneStates

Changements d’état pour cet appareil téléphonique pour lequel l’application peut être avertie dans un message PHONE_STATE . Ce membre est une ou plusieurs constantes PHONESTATE_.

dwHookSwitchDevs

Périphériques hookswitch du téléphone. Ce membre utilise l’une des constantes PHONEHOOKSWITCHDEV_.

dwHandsetHookSwitchModes

Mode Hookswitch du combiné. Le membre n’est significatif que si l’appareil hookswitch est répertorié dans dwHookSwitchDevs. Il utilise l’une des constantes PHONEHOOKSWITCHMODE_.

dwSpeakerHookSwitchModes

Mode Hookswitch du haut-parleur. Le membre n’est significatif que si l’appareil hookswitch est répertorié dans dwHookSwitchDevs. Il utilise l’une des constantes PHONEHOOKSWITCHMODE_.

dwHeadsetHookSwitchModes

Mode Hookswitch du casque. Le membre n’est significatif que si l’appareil hookswitch est répertorié dans dwHookSwitchDevs. Il utilise l’une des constantes PHONEHOOKSWITCHMODE_.

dwVolumeFlags

Fonctionnalités de définition du volume des composants du haut-parleur de l’appareil téléphonique. Si le bit en position PHONEHOOKSWITCHDEV_ a la valeur TRUE, le volume du composant haut-parleur de l’appareil hookswitch correspondant peut être ajusté avec phoneSetVolume.

dwGainFlags

Fonctionnalités de réglage des gains des composants du microphone de l’appareil téléphonique. Si la position du bit PHONEHOOKSWITCHDEV_ a la valeur TRUE, le volume du composant microphone de l’appareil hookswitch correspondant peut être ajusté avec phoneSetGain.

dwDisplayNumRows

Affichez les fonctionnalités de l’appareil téléphonique en décrivant le nombre de lignes dans l’écran du téléphone. Les membres dwDisplayNumRows et dwDisplayNumColumns sont tous deux zéro pour un appareil téléphonique sans écran.

dwDisplayNumColumns

Affichez les fonctionnalités de l’appareil téléphonique en décrivant le nombre de colonnes dans l’écran du téléphone. Les membres dwDisplayNumRows et dwDisplayNumColumns sont tous deux zéro pour un appareil téléphonique sans écran.

dwNumRingModes

Fonctionnalités de sonnerie de l’appareil téléphonique. Le téléphone peut sonner avec dwNumRingModes différents modèles d’anneau , identifiés comme 1, 2, à dwNumRingModes moins un. Si la valeur de ce membre est 0, les applications n’ont aucun contrôle sur le mode d’anneau du téléphone. Si la valeur de ce membre est supérieure à 0, elle indique le nombre de modes d’anneau en plus du silence pris en charge par le fournisseur de services. La valeur 0 dans le paramètre lpdwRingMode de phoneGetRing ou le paramètre dwRingMode de phoneSetRing indique le silence (le téléphone ne sonne pas ou ne doit pas être exécuté), et les valeurs dwRingMode de 1 à dwNumRingModes sont des modes de sonnerie valides pour l’appareil téléphonique.

dwNumButtonLamps

Nombre de boutons/lampes sur l’appareil téléphonique détectables dans TAPI. Les boutons/lampes sont identifiés par leur identificateur. Les identificateurs de bouton/lampe valides vont de zéro à dwNumButtonLamps moins un. Les identificateurs 0 à 12 sont attribués aux boutons du clavier « 0 », « 9 », « * » et « # ».

dwButtonModesSize

Taille du tableau des modes de bouton, en octets.

dwButtonModesOffset

Décalage du début de cette structure vers le champ de taille variable contenant les modes de bouton des boutons du téléphone. Le tableau est indexé par l’identificateur de bouton/lampe. Ce tableau utilise les constantes PHONEBUTTONMODE_. La taille du tableau est spécifiée par dwButtonModesSize.

dwButtonFunctionsSize

Taille du champ fonctions de bouton, en octets.

dwButtonFunctionsOffset

Décalage du début de cette structure vers le champ de taille variable contenant les fonctions de bouton des boutons du téléphone. Le tableau est indexé par l’identificateur de bouton/lampe. Ce tableau utilise les constantes PHONEBUTTONFUNCTION_. La taille du tableau est spécifiée par dwButtonFunctionsSize.

dwLampModesSize

Taille du tableau des modes de lampe, en octets.

dwLampModesOffset

Décalage du début de cette structure vers le champ de dimension variable contenant les modes de lampe des lampes du téléphone. Le tableau est indexé par l’identificateur de bouton/lampe. Ce tableau utilise les constantes PHONELAMPMODE_. La taille du tableau est spécifiée par dwLampModesSize.

dwNumSetData

Nombre de zones de téléchargement différentes dans l’appareil téléphonique. Les différentes zones sont référencées à l’aide des ID de données 0, 1, , dwNumSetData moins un. Si ce membre est égal à zéro, le téléphone ne prend pas en charge la fonctionnalité de téléchargement.

dwSetDataSize

Taille du tableau de taille des données, en octets.

dwSetDataOffset

Décalage du début de cette structure vers le champ de taille variable contenant les tailles (en octets) des zones de données de téléchargement du téléphone. Il s’agit d’un tableau avec des éléments de taille DWORD indexés par identificateur de données. La taille du tableau est spécifiée par dwSetDataSize.

dwNumGetData

Nombre de zones de chargement différentes dans l’appareil téléphonique. Les différentes zones sont référencées à l’aide des ID de données 0, 1, , dwNumGetData moins un. Si ce champ est égal à zéro, le téléphone ne prend pas en charge la fonctionnalité de chargement.

dwGetDataSize

Taille du tableau de taille des données, en octets.

dwGetDataOffset

Décalage du début de cette structure vers le champ de taille variable contenant les tailles (en octets) des zones de données de chargement du téléphone. Il s’agit d’un tableau avec des éléments de taille DWORD indexés par identificateur de données. La taille du tableau est spécifiée par dwGetDataSize.

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 marque de fin Null .

dwDevSpecificOffset

Décalage du début de cette structure vers le champ spécifique à l’appareil de taille variable. La taille du champ est spécifiée par dwDevSpecificSize.

dwDeviceClassesSize

Taille des identificateurs de classe d’appareil pris en charge, en octets.

dwDeviceClassesOffset

Décalage du début de cette structure vers une chaîne composée des identificateurs de classe d’appareil pris en charge sur cet appareil pour une utilisation avec phoneGetID. Les identificateurs sont séparés par des valeurs NULL, et le dernier identificateur de la liste est suivi de deux valeurs NULL. La taille du champ est spécifiée par dwDeviceClassesSize.

dwPhoneFeatures

Indicateurs qui indiquent les fonctions de l’API Téléphonie qui peuvent être appelées sur le téléphone. Un zéro indique que la fonctionnalité correspondante n’est pas implémentée et ne peut jamais être appelée par l’application sur le téléphone ; un indique que la fonctionnalité peut être appelée en fonction de l’état de l’appareil et d’autres facteurs. Ce membre utilise des constantes PHONEFEATURE_.

dwSettableHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valeurs qui peuvent être définies sur le combiné à l’aide de phoneSetHookSwitch.

dwSettableSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_ valeurs qui peuvent être définies sur le téléphone du haut-parleur à l’aide de phoneSetHookSwitch.

dwSettableHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valeurs qui peuvent être définies sur le casque à l’aide de phoneSetHookSwitch.

dwMonitoredHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valeurs qui peuvent être détectées et signalées pour le combiné dans un message PHONE_STATE et par phoneGetHookSwitch.

dwMonitoredSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_ valeurs qui peuvent être détectées et signalées pour le speakerphone dans un message PHONE_STATE et par phoneSetHookSwitch.

dwMonitoredHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valeurs qui peuvent être détectées et signalées pour le casque dans un message PHONE_STATE et par phoneSetHookSwitch.

PermanentPhoneGuid

GUID associé de façon permanente à ce téléphone.

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 dwDeviceClassesSize via dwMonitoredHeadsetHookSwitchModes sont disponibles uniquement pour les applications qui ouvrent l’appareil téléphonique avec une version d’API 2.0 ou ultérieure.