fungsi auxGetVolume (mmeapi.h)
Fungsi auxGetVolume mengambil pengaturan volume saat ini dari perangkat output tambahan yang ditentukan.
Sintaks
MMRESULT auxGetVolume(
UINT uDeviceID,
LPDWORD pdwVolume
);
Parameter
uDeviceID
Pengidentifikasi perangkat output tambahan yang akan dikueri.
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 yang tepat. 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.
Pengaturan 16-bit lengkap yang diatur dengan fungsi auxSetVolume dikembalikan, terlepas dari apakah perangkat mendukung 16 bit penuh kontrol tingkat volume.
Nilai kembali
Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Pengidentifikasi perangkat yang ditentukan berada di luar rentang. |
Keterangan
Tidak semua perangkat mendukung kontrol volume. Untuk menentukan apakah perangkat mendukung kontrol volume, gunakan bendera AUXCAPS_VOLUME untuk menguji anggota dwSupport struktur AUXCAPS (diisi oleh fungsi auxGetDevCaps ).
Untuk menentukan apakah perangkat mendukung kontrol volume pada saluran kiri dan kanan, gunakan bendera AUXCAPS_LRVOLUME untuk menguji anggota dwSupport struktur AUXCAPS (diisi oleh auxGetDevCaps).
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 |