Compartilhar via

Método ITLegacyCallMediaControl2::GenerateCustomTonesByCollection (tapi3if.h)

  • Artigo

O método GenerateCustomTonesByCollection gera o tom personalizado especificado.

Esse método destina-se ao Visual Basic e aos aplicativos de script. Em vez disso, os aplicativos C/C++ devem usar o método GenerateCustomTones .

Sintaxe

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

Parâmetros

[in] pCustomToneCollection

Ponteiro para uma interface ITCollection2 que contém uma coleção de ponteiros de interface ITCustomTone que representam os componentes do tom. Se a coleção for um tom de multifrequência, os vários tons serão reproduzidos simultaneamente.

[in] lDuration

A duração, em milissegundos, durante a qual o tom deve ser sustentado. Um valor zero usa uma duração padrão.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_POINTER
 O parâmetro pCustomToneCollection não é um ponteiro válido.
E_OUTOFMEMORY
 Não há memória suficiente para alocar o buffer de tons.
TAPI_E_INVALCALLSTATE
 A chamada deve estar no estado conectado .

Comentários

Esse método se traduz em uma chamada para o TAPI 2. Função xlineGenerateTone .

Quando a geração de tom é concluída, um evento do tipo TE_GENERATEEVENT é gerado.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2