fonction TSPI_phoneSetGain (tspi.h)
La fonction TSPI_phoneSetGain définit le gain du microphone du périphérique de commutateur de raccordement spécifié au niveau de gain spécifié.
Syntaxe
LONG TSPIAPI TSPI_phoneSetGain(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdPhone
Poignée du téléphone contenant l’appareil hookswitch dont le gain doit être défini.
dwHookSwitchDev
Périphérique hookswitch dont le gain du microphone doit être défini. Ce paramètre utilise une seule des constantes PHONEHOOKSWITCHDEV_.
dwGain
Emplacement de taille DWORD contenant le nouveau paramètre de gain souhaité de l’appareil. 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 gain dans cette plage sont spécifiques au fournisseur de services. Une valeur pour dwGain qui est hors de la plage est limitée par TAPI à la valeur dans la plage la plus proche.
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |