fungsi midiOutGetVolume (mmeapi.h)

Fungsi midiOutGetVolume mengambil pengaturan volume saat ini dari perangkat output MIDI.

Sintaks

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

Parameter

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.

Nilai kembali

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Menampilkan kode Deskripsi
MMSYSERR_INVALHANDLE
Handel perangkat yang ditentukan tidak valid.
MMSYSERR_INVALPARAM
Penunjuk atau struktur yang ditentukan tidak valid.
MMSYSERR_NOMEM
Sistem tak bisa mengalokasikan atau mengunci memori.
MMSYSERR_NOTSUPPORTED
Fungsi ini tidak didukung.

Keterangan

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

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

Lihat juga

Fungsi MIDI