fungsi phoneSetVolume (tapi.h)

Fungsi phoneSetVolume mengatur volume komponen speaker dari perangkat hookswitch yang ditentukan ke tingkat yang ditentukan.

Sintaks

LONG phoneSetVolume(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwVolume
);

Parameter

hPhone

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

dwHookSwitchDev

Perangkat Hookswitch yang volume speakernya akan diatur, salah satu PHONEHOOKSWITCHDEV_ Constants.

dwVolume

Pengaturan volume baru perangkat. Parameter dwVolume menentukan tingkat volume perangkat hookswitch. Ini adalah angka dalam rentang 0x00000000 (keheningan) hingga 0x0000FFFF (volume maksimum). Granularitas aktual dan kuantisasi pengaturan volume dalam rentang ini khusus untuk penyedia layanan. Nilai untuk dwVolume 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