Tangani ke objek perangkat mixer yang mengontrol baris audio tertentu.
pmxl
Penunjuk ke struktur MIXERLINE . Struktur ini diisi dengan informasi tentang garis audio untuk perangkat mixer. AnggotacbStruct harus selalu diinisialisasi menjadi ukuran, dalam byte, dari struktur MIXERLINE .
fdwInfo
Bendera untuk mengambil informasi tentang garis audio. Nilai berikut ditentukan.
Nilai
Arti
MIXER_GETLINEINFOF_COMPONENTTYPE
Parameter pmxl akan menerima informasi tentang baris audio pertama dari jenis yang ditentukan dalam dwComponentType anggota struktur MIXERLINE . Bendera ini digunakan untuk mengambil informasi tentang baris audio dari jenis komponen tertentu. Anggota struktur yang tersisa kecuali cbStruct tidak memerlukan inisialisasi lebih lanjut.
MIXER_GETLINEINFOF_DESTINATION
Parameter pmxl akan menerima informasi tentang baris audio tujuan yang ditentukan oleh dwDestination anggota struktur MIXERLINE . Indeks ini berkisar dari nol hingga satu kurang dari nilai dalam cDestinations anggota struktur MIXERCAPS . Semua anggota struktur yang tersisa kecuali cbStruct tidak memerlukan inisialisasi lebih lanjut.
MIXER_GETLINEINFOF_LINEID
Parameter pmxl akan menerima informasi tentang baris audio yang ditentukan oleh dwLineID anggota struktur MIXERLINE . Ini biasanya digunakan untuk mengambil informasi yang diperbarui tentang status baris audio. Semua anggota struktur yang tersisa kecuali cbStruct tidak memerlukan inisialisasi lebih lanjut.
MIXER_GETLINEINFOF_SOURCE
Parameter pmxl akan menerima informasi tentang baris audio sumber yang ditentukan oleh dwDestination dan dwSource anggota struktur MIXERLINE. Indeks yang ditentukan oleh dwDestination berkisar dari nol hingga satu kurang dari nilai dalam cDestinations anggota struktur MIXERCAPS . Indeks yang ditentukan oleh dwSource berkisar dari nol hingga satu kurang dari nilai dalam cConnections anggota struktur MIXERLINE yang dikembalikan untuk baris audio yang disimpan di dwDestination anggota. Semua anggota struktur yang tersisa kecuali cbStruct tidak memerlukan inisialisasi lebih lanjut.
MIXER_GETLINEINFOF_TARGETTYPE
Parameter pmxl akan menerima informasi tentang baris audio yang untuk dwType anggota struktur Target , yang merupakan anggota struktur MIXERLINE . Bendera ini digunakan untuk mengambil informasi tentang garis audio yang menangani jenis target (misalnya, MIXERLINE_TARGETTYPE_WAVEOUT). Aplikasi harus menginisialisasi dwType, wMid, wPid, vDriverVersion dan szPname anggota struktur MIXERLINE sebelum memanggil mixerGetLineInfo. Semua nilai ini dapat diambil dari struktur kemampuan perangkat untuk semua perangkat media. Anggota struktur yang tersisa kecuali cbStruct tidak memerlukan inisialisasi lebih lanjut.
Catatan Dalam versi ANSI fungsi ini (mixerGetLineInfoA), Anda tidak dapat menggunakan string ANSI yang dikembalikan dari mixerGetLineInfo atau waveOutGetDevCaps untuk nilai string psPname saat memanggil mixerGetLineInfo dengan bendera MIXER_GETLINEINFOF_TARGETTYPE. Alasannya adalah bahwa konversi internal ke dan dari Unicode dilakukan, yang dapat mengakibatkan hilangnya data.
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. 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_INVALLINE
Referensi baris audio 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
Catatan
Header mmeapi.h mendefinisikan mixerGetLineInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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]