fonction phoneGetGain (tapi.h)

  • Article

La fonction phoneGetGain retourne le paramètre de gain du microphone du périphérique hookswitch du téléphone spécifié.

Syntaxe

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert.

dwHookSwitchDev

Périphérique hookswitch dont le niveau de gain est interrogé. Le paramètre dwHookSwitchDev ne peut avoir qu’un seul jeu de bits. Ce paramètre utilise une seule des constantes PHONEHOOKSWITCHDEV_.

lpdwGain

Pointeur vers un DWORD contenant le paramètre de gain actuel du composant microphone hookswitch. Le paramètre dwGain spécifie le niveau de volume du périphérique hookswitch. Il s’agit d’un nombre compris dans la plage 0x00000000 (silence) à 0x0000FFFF (volume maximal). La granularité réelle et la quantisation des paramètres de gain dans cette plage sont spécifiques au fournisseur de services.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2