fonction phoneSetVolume (tapi.h)
La fonction phoneSetVolume définit le volume du composant haut-parleur du périphérique de commutateur de connexion spécifié au niveau spécifié.
Syntaxe
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Paramètres
hPhone
Gérez l’appareil téléphonique ouvert. L’application doit être le propriétaire du téléphone.
dwHookSwitchDev
Périphérique hookswitch dont le volume de l’orateur doit être défini, l’une des constantes PHONEHOOKSWITCHDEV_.
dwVolume
Nouveau paramètre de volume de l’appareil. Le paramètre dwVolume 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é et la quantisation réelles des paramètres de volume dans cette plage sont spécifiques au fournisseur de services. Une valeur pour dwVolume qui est hors de la 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 numéro 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 |