fonction TSPI_phoneSetVolume (tspi.h)
La fonction TSPI_phoneSetVolume définit le volume du composant de haut-parleur du périphérique de commutateur de connexion spécifié au niveau spécifié.
Syntaxe
LONG TSPIAPI TSPI_phoneSetVolume(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdPhone
Poignée du téléphone contenant le haut-parleur dont le volume doit être défini.
dwHookSwitchDev
Identifie le périphérique hookswitch dont le volume de l’orateur doit être défini. Ce paramètre utilise l’une des constantes PHONEHOOKSWITCHDEV_.
dwVolume
DWORD spécifiant le nouveau niveau de volume du périphérique hookswitch. Il s’agit d’un nombre compris entre 0x00000000 (silence) et 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 limitée par TAPI à la valeur la plus proche dans la plage.
Valeur retournée
Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’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.
Notes
Aucun.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |