Partager via


ITDetectTone::get_Frequency, méthode (tapi3if.h)

La méthode get_Frequency récupère la fréquence de la tonalité pour laquelle le serveur TAPI génère un événement de tonalité.

Syntaxe

HRESULT get_Frequency(
  [in]  long Index,
  [out] long *plFrequency
);

Paramètres

[in] Index

Spécifie l’index de la tonalité.

[out] plFrequency

Pointeur vers une valeur pour recevoir la fréquence, en hertz, de la tonalité. Pour plus d'informations, consultez la section Notes qui suit.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
La méthode a réussi.
E_POINTER
Le paramètre plFrequency n’est pas un pointeur valide.

Remarques

Vous pouvez configurer jusqu’à trois fréquences qui composent les composants d’une tonalité. Si moins de trois fréquences sont requises, spécifiez une valeur de zéro pour les fréquences inutilisées. Un ton avec les trois fréquences définies sur zéro est interprété comme silence et peut être utilisé pour la détection du silence.

Configuration requise

   
Plateforme cible Windows
En-tête tapi3if.h
Bibliothèque Uuid.lib
DLL Tapi3.dll

Voir aussi

ITDetectTone

put_Frequency