Baca dalam bahasa Inggris

Bagikan melalui


fungsi mixerGetLineInfoW (mmeapi.h)

Fungsi mixerGetLineInfo mengambil informasi tentang baris tertentu dari perangkat mixer.

Sintaksis

MMRESULT mixerGetLineInfoW(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEW pmxl,
  DWORD        fdwInfo
);

Parameter

hmxobj

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. Anggota cbStruct 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]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header mmeapi.h (termasuk Windows.h)
Pustaka Winmm.lib
DLL Winmm.dll

Lihat juga

Audio Mixer Functions

Audio Mixer