Partager via


fonction TSPI_phoneGetGain (tspi.h)

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

Syntaxe

LONG TSPIAPI TSPI_phoneGetGain(
  HDRVPHONE hdPhone,
  DWORD     dwHookSwitchDev,
  LPDWORD   lpdwGain
);

Paramètres

hdPhone

Handle du téléphone dont le gain doit être récupéré.

dwHookSwitchDev

Périphérique hookswitch dont le niveau de gain est interrogé. Ce paramètre peut être l’une des constantes PHONEHOOKSWITCHDEV_.

lpdwGain

Pointeur vers un emplacement de taille DWORD dans lequel le fournisseur de services écrit le paramètre de gain actuel du composant de microphone hookswitch. Le paramètre gain dwGain spécifie le niveau de volume du périphérique hookswitch. Il s’agit d’un nombre compris entre 0x00000000 (silence) et 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 fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Configuration requise

   
Plateforme cible Windows
En-tête tspi.h

Voir aussi

PHONECAPS

TSPI_phoneGetDevCaps

TSPI_phoneSetGain