Partager via


fonction phoneGetVolume (tapi.h)

La fonction phoneGetVolume retourne le paramètre de volume de l’appareil hookswitch du téléphone spécifié.

Syntaxe

LONG phoneGetVolume(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwVolume
);

Paramètres

hPhone

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

dwHookSwitchDev

Appareil à commutateur de raccordement unique dont le niveau de volume est interrogé. Ce paramètre utilise l’une des constantes PHONEHOOKSWITCHDEV_.

lpdwVolume

Pointeur vers un DWORD. La fonction retourne le paramètre de volume actuel de l’appareil hookswitch à cet emplacement. 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_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

Voir aussi

Fonctions de service téléphonique supplémentaires

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