fungsi phoneSetGain (tapi.h)

  • Artikel

Fungsi phoneSetGain menetapkan perolehan mikrofon perangkat hookswitch yang ditentukan ke tingkat penguatan yang ditentukan.

Sintaks

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

Parameter

hPhone

Tangani ke perangkat telepon terbuka. Aplikasi harus menjadi pemilik telepon.

dwHookSwitchDev

Perangkat Hookswitch yang keuntungan mikrofonnya akan diatur. Parameter ini menggunakan satu dan hanya satu dari konstanta PHONEHOOKSWITCHDEV_.

dwGain

Arahkan ke DWORD yang berisi pengaturan perolehan baru perangkat. Parameter dwGain menentukan tingkat perolehan perangkat hookswitch. Ini adalah angka dalam rentang 0x00000000 (keheningan) hingga 0x0000FFFF (volume maksimum). Granularitas aktual dan kuantisasi pengaturan perolehan dalam rentang ini khusus untuk penyedia layanan. Nilai untuk dwGain yang berada di luar rentang diatur ke nilai terdekat dalam rentang.

Mengembalikan nilai

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan PHONE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

PHONE_REPLY

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2