fonction phoneSetGain (tapi.h)
La fonction phoneSetGain définit le gain du microphone du périphérique hookswitch spécifié sur le niveau de gain spécifié.
Syntaxe
LONG phoneSetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
Paramètres
hPhone
Gérez l’appareil téléphonique ouvert. L’application doit être propriétaire du téléphone.
dwHookSwitchDev
Périphérique Hookswitch dont le gain du microphone doit être défini. Ce paramètre utilise une seule des constantes PHONEHOOKSWITCHDEV_.
dwGain
Pointeur vers un DWORD contenant le nouveau paramètre de gain de l’appareil. Le paramètre dwGain spécifie le niveau de gain de l’appareil hookswitch. Il s’agit d’un nombre compris dans la plage 0x00000000 (silence) à 0x0000FFFF (volume maximal). La granularité et la quantisation réelles des paramètres de gain dans cette plage sont spécifiques au fournisseur de services. Une valeur pour dwGain qui est hors plage est définie sur la valeur la plus proche de la plage.
Valeur retournée
Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone ou un nombre d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message PHONE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’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_NOTOWNER, 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 |