fonction phoneGetRing (tapi.h)

  • Article

La fonction phoneGetRing permet à une application d’interroger l’appareil téléphonique ouvert spécifié en fonction de son mode d’anneau actuel.

Syntaxe

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert.

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 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.

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Remarques

Le fournisseur de services définit les modèles de sonnerie sonores réels correspondant à chacun des modes d’sonnerie du téléphone.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2