fungsi midiOutGetVolume (mmeapi.h)
Fungsi midiOutGetVolume mengambil pengaturan volume saat ini dari perangkat output MIDI.
MMRESULT midiOutGetVolume(
HMIDIOUT hmo,
LPDWORD pdwVolume
);
hmo
Menangani ke perangkat output MIDI terbuka. Parameter ini juga dapat berisi handel aliran MIDI, selama dilemparkan ke HMIDIOUT. Parameter ini juga dapat menjadi pengidentifikasi perangkat.
pdwVolume
Arahkan ke lokasi untuk memuat pengaturan volume saat ini. Kata urutan rendah dari lokasi ini berisi pengaturan volume saluran kiri, dan kata urutan tinggi berisi pengaturan saluran kanan. Nilai 0xFFFF mewakili volume penuh, dan nilai 0x0000 diam.
Jika perangkat tidak mendukung kontrol volume kiri dan kanan, kata urutan rendah dari lokasi yang ditentukan berisi tingkat volume mono.
Nilai apa pun yang ditetapkan dengan menggunakan fungsi midiOutSetVolume dikembalikan, terlepas dari apakah perangkat mendukung nilai tersebut.
Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Handel perangkat yang ditentukan tidak valid. |
|
Penunjuk atau struktur yang ditentukan tidak valid. |
|
Sistem tak bisa mengalokasikan atau mengunci memori. |
|
Fungsi ini tidak didukung. |
Jika pengidentifikasi perangkat digunakan, maka hasil panggilan midiOutGetVolume dan informasi yang dikembalikan dalam lpdwVolume berlaku untuk semua instans perangkat. Jika handel perangkat digunakan, maka hasil dan informasi yang dikembalikan hanya berlaku untuk instans perangkat yang direferensikan oleh handel perangkat.
Tidak semua perangkat mendukung kontrol volume. Anda dapat menentukan apakah perangkat mendukung kontrol volume dengan mengkueri perangkat dengan menggunakan fungsi midiOutGetDevCaps dan menentukan bendera MIDICAPS_VOLUME.
Anda juga dapat menentukan apakah perangkat mendukung kontrol volume di saluran kiri dan kanan dengan mengkueri perangkat dengan menggunakan fungsi midiOutGetDevCaps dan menentukan bendera MIDICAPS_LRVOLUME.
Persyaratan | Nilai |
---|---|
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 |