Baca dalam bahasa Inggris

Bagikan melalui


fungsi mixerGetControlDetailsA (mmeapi.h)

Fungsi mixerGetControlDetails mengambil detail tentang satu kontrol yang terkait dengan garis audio.

Sintaksis

MMRESULT mixerGetControlDetailsA(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Parameter

hmxobj

Tangani ke objek perangkat mixer yang sedang dikueri.

pmxcd

Penunjuk ke struktur MIXERCONTROLDETAILS, yang diisi dengan informasi status tentang kontrol.

fdwDetails

Bendera untuk mengambil detail kontrol. Nilai berikut ditentukan.

Nilai Arti
MIXER_GETCONTROLDETAILSF_LISTTEXT PaDetail anggota struktur MIXERCONTROLDETAILS ke satu atau beberapa struktur MIXERCONTROLDETAILS_LISTTEXT untuk menerima label teks untuk kontrol beberapa item. Aplikasi harus mendapatkan semua item teks daftar untuk kontrol beberapa item sekaligus. Bendera ini tidak dapat digunakan dengan kontrol MIXERCONTROL_CONTROLTYPE_CUSTOM.
MIXER_GETCONTROLDETAILSF_VALUE Nilai saat ini untuk kontrol diambil. paDetails anggota struktur MIXERCONTROLDETAILS ke satu atau beberapa struktur detail yang sesuai untuk kelas kontrol.
MIXER_OBJECTF_AUX Parameter hmxobj adalah pengidentifikasi perangkat tambahan dalam kisaran nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN Parameter hmxobj adalah handel perangkat input MIDI (Musical Instrument Digital Interface). Handel ini harus dikembalikan oleh fungsi midiInOpen .
MIXER_OBJECTF_HMIDIOUT Parameter hmxobj adalah handel perangkat output MIDI. Handel ini harus dikembalikan oleh fungsi midiOutOpen.
MIXER_OBJECTF_HMIXER Parameter hmxobj adalah handel perangkat mixer yang dikembalikan oleh fungsi mixerOpen. Bendera ini bersifat opsional.
MIXER_OBJECTF_HWAVEIN Parameter hmxobj adalah handel input waveform-audio yang dikembalikan oleh fungsi waveInOpen .
MIXER_OBJECTF_HWAVEOUT Parameter hmxobj adalah handel output waveform-audio yang dikembalikan oleh fungsi waveOutOpen.
MIXER_OBJECTF_MIDIIN Parameter hmxobj adalah pengidentifikasi perangkat input MIDI. Pengidentifikasi ini harus berada dalam rentang nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT Parameter hmxobj adalah pengidentifikasi perangkat output MIDI. Pengidentifikasi ini harus berada dalam rentang nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi midiOutGetNumDevs .
MIXER_OBJECTF_MIXER Parameter hmxobj adalah pengidentifikasi perangkat mixer dalam kisaran nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi mixerGetNumDevs. Bendera ini bersifat opsional.
MIXER_OBJECTF_WAVEIN Parameter hmxobj adalah pengidentifikasi perangkat input waveform-audio dalam kisaran nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT Parameter hmxobj adalah pengidentifikasi perangkat output waveform-audio dalam kisaran nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi waveOutGetNumDevs .

Mengembalikan nilai

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

Mengembalikan kode Deskripsi
MIXERR_INVALCONTROL
Referensi kontrol tidak valid.
MMSYSERR_BADDEVICEID
Parameter hmxobj menentukan pengidentifikasi perangkat yang tidak valid.
MMSYSERR_INVALFLAG
Satu atau beberapa bendera tidak valid.
MMSYSERR_INVALHANDLE
Parameter hmxobj menentukan handel yang tidak valid.
MMSYSERR_INVALPARAM
Satu atau beberapa parameter tidak valid.
MMSYSERR_NODRIVER
Tidak ada perangkat mixer yang tersedia untuk objek yang ditentukan oleh hmxobj.

Komentar

Semua anggota struktur MIXERCONTROLDETAILS harus diinisialisasi sebelum memanggil fungsi ini.

Catatan

Header mmeapi.h mendefinisikan mixerGetControlDetails sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header mmeapi.h (termasuk Mmeapi.h, Windows.h)
Pustaka Winmm.lib
DLL Winmm.dll

Lihat juga

Audio Mixer Functions

Audio Mixer