fungsi phoneGetGain (tapi.h)

Fungsi phoneGetGain mengembalikan pengaturan perolehan mikrofon dari perangkat hookswitch ponsel yang ditentukan.

Sintaks

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

Parameter

hPhone

Tangani ke perangkat telepon terbuka.

dwHookSwitchDev

Perangkat Hookswitch yang tingkat penguatannya dikueri. Parameter dwHookSwitchDev hanya dapat memiliki satu set bit. Parameter ini menggunakan satu dan hanya satu dari konstanta PHONEHOOKSWITCHDEV_.

lpdwGain

Arahkan ke DWORD yang berisi pengaturan perolehan saat ini dari komponen mikrofon hookswitch. Parameter dwGain menentukan tingkat volume 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.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, 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

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2