MÉTHODE ITLegacyCallMediaControl2 ::GenerateCustomTonesByCollection (tapi3if.h)

Article
03/04/2024

La méthode GenerateCustomTonesByCollection génère la tonalité personnalisée spécifiée.

Cette méthode est destinée aux applications Visual Basic et de script. Les applications C/C++ doivent utiliser la méthode GenerateCustomTones à la place.

Syntaxe

HRESULT GenerateCustomTonesByCollection(
  [in] ITCollection2 *pCustomToneCollection,
  [in] long          lDuration
);

Paramètres

[in] pCustomToneCollection

Pointeur vers une interface ITCollection2 contenant une collection de pointeurs d’interface ITCustomTone représentant les composants de la tonalité. Si la collection est une tonalité multiréfréquence, les différentes tonalités sont lues simultanément.

[in] lDuration

Durée, en millisecondes, pendant laquelle la tonalité doit être maintenue. La valeur zéro utilise une durée par défaut.

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 pCustomToneCollection n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour allouer la mémoire tampon des tonalités.
TAPI_E_INVALCALLSTATE	L’appel doit être dans l’état connecté .

Remarques

Cette méthode se traduit par un appel au TAPI 2. fonction xlineGenerateTone .

Une fois la génération de tonalités terminée, un événement de type TE_GENERATEEVENT est généré.

Configuration requise

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

Voir aussi

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2

Partager via