TSPI_phoneGetRing, fonction (tspi.h)
La fonction TSPI_phoneGetRing permet à une application d’interroger l’appareil téléphonique ouvert spécifié en fonction de son mode d’anneau actuel.
Syntaxe
LONG TSPIAPI TSPI_phoneGetRing(
HDRVPHONE hdPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
Paramètres
hdPhone
Poignée du téléphone dont le mode de sonnerie doit être interrogé.
lpdwRingMode
Modèle de sonnerie avec laquelle le téléphone sonne. Zéro indique que le téléphone ne sonne pas.
lpdwVolume
Niveau de volume avec lequel le téléphone sonne. 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.
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_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Remarques
Le fournisseur de services définit les modèles de sonnerie sonores réels correspondant à chacun des modes de sonnerie du téléphone.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |