fungsi waveOutGetVolume (mmeapi.h)

Fungsi waveOutGetVolume mengambil tingkat volume saat ini dari perangkat output waveform-audio yang ditentukan.

Sintaks

MMRESULT waveOutGetVolume(
  HWAVEOUT hwo,
  LPDWORD  pdwVolume
);

Parameter

hwo

Menangani ke perangkat output waveform-audio terbuka. Parameter ini juga dapat menjadi pengidentifikasi perangkat.

pdwVolume

Penunjuk ke variabel yang akan diisi dengan pengaturan volume saat ini. Kata berurutan rendah dari lokasi ini berisi pengaturan volume saluran kiri, dan kata berurutan tinggi berisi pengaturan saluran kanan. Nilai 0xFFFF mewakili volume penuh, dan nilai 0x0000 diam.

Jika perangkat tidak mendukung kontrol volume kiri dan kanan, kata berurutan rendah dari lokasi yang ditentukan berisi tingkat volume mono.

Pengaturan 16-bit lengkap yang diatur dengan fungsi waveOutSetVolume dikembalikan, terlepas dari apakah perangkat mendukung 16 bit penuh kontrol tingkat volume.

Menampilkan nilai

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMSYSERR_INVALHANDLE	Handel perangkat yang ditentukan tidak valid.
MMSYSERR_NODRIVER	Tidak ada driver perangkat.
MMSYSERR_NOMEM	Tidak dapat mengalokasikan atau mengunci memori.
MMSYSERR_NOTSUPPORTED	Fungsi tidak didukung.

Keterangan

Jika pengidentifikasi perangkat digunakan, maka hasil panggilan waveOutGetVolume dan informasi yang dikembalikan dalam pdwVolume berlaku untuk semua instans perangkat. Jika handel perangkat digunakan, hasil dan informasi yang dikembalikan hanya berlaku untuk instans perangkat yang direferensikan oleh handel perangkat.

Tidak semua perangkat mendukung perubahan volume. Untuk menentukan apakah perangkat mendukung kontrol volume, gunakan bendera WAVECAPS_VOLUME untuk menguji anggota dwSupport dari struktur WAVEOUTCAPS (diisi oleh fungsi waveOutGetDevCaps ).

Untuk menentukan apakah perangkat mendukung kontrol volume saluran kiri dan kanan, gunakan bendera WAVECAPS_LRVOLUME untuk menguji anggota dwSupport struktur WAVEOUTCAPS (diisi oleh waveOutGetDevCaps).

Pengaturan volume ditafsirkan secara logaritma. Ini berarti peningkatan volume yang dirasakan sama ketika meningkatkan tingkat volume dari 0x5000 ke 0x6000 seperti halnya dari 0x4000 ke 0x5000.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mmeapi.h (termasuk Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Waveform Audio

Fungsi Bentuk Gelombang