fungsi mixerGetID (mmeapi.h)

Artikel
03/15/2023

Fungsi mixerGetID mengambil pengidentifikasi perangkat untuk perangkat mixer yang terkait dengan handel perangkat tertentu.

Sintaks

MMRESULT mixerGetID(
  HMIXEROBJ hmxobj,
  UINT      *puMxId,
  DWORD     fdwId
);

Parameter

hmxobj

Tangani ke objek mixer audio untuk memetakan ke pengidentifikasi perangkat mixer.

puMxId

Penunjuk ke variabel yang menerima pengidentifikasi perangkat mixer. Jika tidak ada perangkat mixer yang tersedia untuk objek hmxobj , nilai -1 ditempatkan di lokasi ini dan nilai kesalahan MMSYSERR_NODRIVER dikembalikan.

fdwId

Bendera untuk memetakan objek mixer hmxobj. Nilai berikut ditentukan.

Nilai	Makna
MIXER_OBJECTF_AUX	Parameter hmxobj adalah pengidentifikasi perangkat tambahan dalam rentang nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN	Parameter hmxobj adalah handel dari perangkat input MIDI. Handel ini harus dikembalikan oleh fungsi midiInOpen .
MIXER_OBJECTF_HMIDIOUT	Parameter hmxobj adalah handel dari 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 rentang 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 rentang nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	Parameter hmxobj adalah pengidentifikasi perangkat output waveform-audio dalam rentang nol hingga satu kurang dari jumlah perangkat yang dikembalikan oleh fungsi waveOutGetNumDevs .

Nilai kembali

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
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 audio yang tersedia untuk objek yang ditentukan oleh hmxobj. Lokasi yang dirujuk oleh puMxId juga berisi nilai -1.

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 Mixer Audio

Mixer Audio

Bagikan melalui