ITLegacyCallMediaControl2::GenerateCustomTonesByCollection method (tapi3if.h)

Metode GenerateCustomTonesByCollection menghasilkan nada kustom yang ditentukan.

Metode ini ditujukan untuk Aplikasi Visual Basic dan pembuatan skrip. Aplikasi C/C++ harus menggunakan metode GenerateCustomTones sebagai gantinya.

Sintaks

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

Parameter

[in] pCustomToneCollection

Arahkan ke antarmuka ITCollection2 yang berisi kumpulan penunjuk antarmuka ITCustomTone yang mewakili komponen nada. Jika koleksi adalah nada multifrekuensi, berbagai nada dimainkan secara bersamaan.

[in] lDuration

Durasi, dalam milidetik, di mana nada harus dipertahankan. Nilai nol menggunakan durasi default.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.
E_POINTER
Parameter pCustomToneCollection bukan penunjuk yang valid.
E_OUTOFMEMORY
Memori tidak cukup untuk mengalokasikan buffer nada.
TAPI_E_INVALCALLSTATE
Panggilan harus dalam status tersambung .

Keterangan

Metode ini diterjemahkan ke panggilan ke TAPI 2. xfungsi lineGenerateTone .

Ketika pembuatan nada selesai, peristiwa jenis TE_GENERATEEVENT dihasilkan.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi3if.h
Pustaka Uuid.lib
DLL Tapi3.dll

Lihat juga

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2