fungsi auxSetVolume (mmeapi.h)
Fungsi auxSetVolume mengatur volume perangkat output tambahan yang ditentukan.
Sintaks
MMRESULT auxSetVolume(
UINT uDeviceID,
DWORD dwVolume
);
Parameter
uDeviceID
Pengidentifikasi perangkat output tambahan yang akan dikueri. Pengidentifikasi perangkat ditentukan secara implisit dari jumlah perangkat yang ada dalam sistem. Nilai pengidentifikasi perangkat berkisar dari nol hingga satu kurang dari jumlah perangkat yang ada. Gunakan fungsi auxGetNumDevs untuk menentukan jumlah perangkat tambahan dalam sistem.
dwVolume
Menentukan pengaturan volume baru. Kata berurutan rendah menentukan pengaturan volume saluran kiri, dan kata urutan tinggi menentukan pengaturan saluran kanan. Nilai 0xFFFF mewakili volume penuh, dan nilai 0x0000 diam.
Jika perangkat tidak mendukung kontrol volume kiri dan kanan, kata dwVolume berurutan rendah menentukan tingkat volume, dan kata urutan tinggi diabaikan.
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).
Sebagian besar perangkat tidak mendukung 16 bit penuh kontrol tingkat volume dan hanya akan menggunakan bit urutan tinggi dari pengaturan volume yang diminta. Misalnya, untuk perangkat yang mendukung kontrol volume 4 bit, nilai tingkat volume yang diminta dari 0x4000, 0x4FFF, dan 0x43BE akan menghasilkan pengaturan volume fisik yang sama, 0x4000. Fungsi auxGetVolume akan mengembalikan pengaturan 16-bit penuh yang diatur dengan auxSetVolume.
Pengaturan volume ditafsirkan secara logaritma. Ini berarti peningkatan volume yang dirasakan sama ketika meningkatkan tingkat volume dari 0x5000 ke 0x6000 karena dari 0x4000 ke 0x5000.
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 |