Struktur MIXERLINEW (mmeapi.h)

Artikel
11/20/2024

Struktur MIXERLINE menjelaskan status dan metrik garis audio.

Sintaksis

typedef struct tagMIXERLINEW {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  WCHAR     szShortName[MIXER_SHORT_NAME_CHARS];
  WCHAR     szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    WCHAR     szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEW, *PMIXERLINEW, *LPMIXERLINEW;

Anggota

cbStruct

Ukuran, dalam byte, dari struktur MIXERLINE . Anggota ini harus diinisialisasi sebelum memanggil fungsi mixerGetLineInfo . Ukuran yang ditentukan dalam anggota ini harus cukup besar untuk memuat struktur MIXERLINE. Saat mixerGetLineInfo kembali, anggota ini berisi ukuran aktual informasi yang dikembalikan. Informasi yang dikembalikan tidak akan melebihi ukuran yang diminta.

dwDestination

Indeks baris tujuan. Anggota ini berkisar dari nol hingga satu kurang dari nilai yang ditentukan dalam cDestinations anggota struktur MIXERCAPS yang diambil oleh fungsi mixerGetDevCaps . Ketika fungsi mixerGetLineInfo dipanggil dengan bendera MIXER_GETLINEINFOF_DESTINATION, properti untuk baris tujuan dikembalikan. (Anggota dwSource harus diatur ke nol dalam kasus ini.) Ketika dipanggil dengan bendera MIXER_GETLINEINFOF_SOURCE, properti untuk sumber yang diberikan oleh anggota dwSource yang terkait dengan dwDestination anggota dikembalikan.

dwSource

Indeks untuk baris sumber audio yang terkait dengan dwDestination anggota. Artinya, anggota ini menentukan nbaris sumber audio th yang terkait dengan baris tujuan audio yang ditentukan. Anggota ini tidak digunakan untuk baris tujuan dan harus diatur ke nol ketika MIXER_GETLINEINFOF_DESTINATION ditentukan dalam fungsi mixerGetLineInfo . Ketika bendera MIXER_GETLINEINFOF_SOURCE ditentukan, anggota ini berkisar dari nol hingga satu kurang dari nilai yang ditentukan dalam cConnections anggota untuk baris tujuan audio yang diberikan dalam dwDestination anggota.

dwLineID

Pengidentifikasi yang ditentukan oleh perangkat mixer yang secara unik mengacu pada garis audio yang dijelaskan oleh struktur MIXERLINE . Pengidentifikasi ini unik untuk setiap perangkat mixer dan dapat dalam format apa pun. Aplikasi harus menggunakan pengidentifikasi ini hanya sebagai handel abstrak.

fdwLine

Bendera status dan dukungan untuk baris audio. Anggota ini selalu dikembalikan ke aplikasi dan tidak memerlukan inisialisasi.

Nama	Deskripsi
MIXERLINE_LINEF_ACTIVE	Baris audio aktif. Garis aktif menunjukkan bahwa sinyal mungkin melewati garis.
MIXERLINE_LINEF_DISCONNECTED	Garis audio terputus. Kontrol terkait garis yang terputus masih dapat dimodifikasi, tetapi perubahan tidak berpengaruh hingga garis tersambung.
MIXERLINE_LINEF_SOURCE	Baris audio adalah baris sumber audio yang terkait dengan satu baris tujuan audio. Jika bendera ini tidak diatur, baris ini adalah garis tujuan audio yang terkait dengan nol atau lebih baris sumber audio.

Jika aplikasi tidak menggunakan perangkat output waveform-audio, baris audio yang terkait dengan perangkat tersebut tidak akan aktif (artinya, bendera MIXERLINE_LINEF_ACTIVE tidak akan diatur).

Jika perangkat output waveform-audio dibuka, maka baris audio dianggap aktif dan bendera MIXERLINE_LINEF_ACTIVE akan diatur.

Perangkat output waveform-audio yang dijeda atau kelaparan masih dianggap aktif. Dengan kata lain, jika perangkat output waveform-audio dibuka oleh aplikasi terlepas dari apakah data sedang diputar, baris audio terkait dianggap aktif.

Jika baris tidak dapat didefinisikan secara ketat sebagai aktif, perangkat mixer akan selalu mengatur bendera MIXERLINE_LINEF_ACTIVE.

dwUser

Data instans yang ditentukan oleh perangkat audio untuk baris tersebut. Anggota ini ditujukan untuk aplikasi mixer kustom yang dirancang khusus untuk perangkat mixer yang mengembalikan informasi ini. Aplikasi lain harus mengabaikan data ini.

dwComponentType

Jenis komponen untuk baris audio ini. Aplikasi dapat menggunakan informasi ini untuk menampilkan grafik yang disesuaikan atau untuk mencari komponen tertentu. Jika aplikasi tidak menggunakan jenis komponen, anggota ini harus diabaikan. Anggota ini bisa menjadi salah satu nilai berikut:

Nama	Deskripsi
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	Baris audio adalah tujuan digital (misalnya, input digital ke perangkat audio DAT atau CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	Garis audio adalah tujuan yang dapat disesuaikan (gain dan/atau attenuation) yang dimaksudkan untuk mendorong headphone. Sebagian besar kartu audio menggunakan garis tujuan audio yang sama untuk speaker dan headphone, dalam hal ini perangkat mixer hanya menggunakan jenis MIXERLINE_COMPONENTTYPE_DST_SPEAKERS.
MIXERLINE_COMPONENTTYPE_DST_LINE	Baris audio adalah tujuan tingkat garis (misalnya, input tingkat baris dari perangkat audio CD) yang akan menjadi sumber perekaman akhir untuk konverter analog-ke-digital (ADC). Karena sebagian besar kartu audio untuk komputer pribadi memberikan semacam keuntungan untuk baris sumber audio rekaman, perangkat mixer akan menggunakan jenis MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	Baris audio adalah tujuan yang digunakan untuk monitor.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	Garis audio adalah tujuan yang dapat disesuaikan (gain dan/atau attenuation) yang dimaksudkan untuk mendorong speaker. Ini adalah jenis komponen umum untuk output audio kartu audio untuk komputer pribadi.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	Baris audio adalah tujuan yang akan dirutekan ke saluran telepon.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	Baris audio adalah tujuan yang tidak dapat ditentukan oleh salah satu jenis komponen standar. Perangkat mixer diperlukan untuk menggunakan jenis komponen ini untuk jenis komponen garis yang belum ditentukan oleh Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	Baris audio adalah tujuan yang akan menjadi sumber perekaman akhir untuk input suara. Jenis komponen ini persis seperti MIXERLINE_COMPONENTTYPE_DST_WAVEIN tetapi dimaksudkan khusus untuk pengaturan yang digunakan selama perekaman/pengenalan suara. Dukungan untuk baris ini bersifat opsional untuk perangkat mixer. Banyak perangkat mixer hanya menyediakan MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	Baris audio adalah tujuan yang akan menjadi sumber perekaman akhir untuk input waveform-audio (ADC). Baris ini biasanya memberikan semacam keuntungan atau redaman. Ini adalah jenis komponen umum untuk baris perekaman sebagian besar kartu audio untuk komputer pribadi.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	Baris audio adalah sumber analog (misalnya, output analog dari pita kaset video).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	Baris audio adalah sumber yang berasal dari baris audio tambahan. Jenis baris ini dimaksudkan sebagai sumber dengan keuntungan atau peledakan yang dapat dirutekan ke tujuan MIXERLINE_COMPONENTTYPE_DST_SPEAKERS dan/atau direkam dari tujuan MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	Baris audio adalah sumber yang berasal dari output CD audio internal. Jenis komponen ini disediakan untuk kartu audio yang menyediakan baris sumber audio yang dimaksudkan untuk disambungkan ke CD audio (atau CD-ROM memutar CD audio).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	Baris audio adalah sumber digital (misalnya, output digital dari DAT atau CD audio).
MIXERLINE_COMPONENTTYPE_SRC_LINE	Baris audio adalah sumber tingkat baris (misalnya, input tingkat baris dari stereo eksternal) yang dapat digunakan sebagai sumber perekaman opsional. Karena sebagian besar kartu audio untuk komputer pribadi memberikan semacam keuntungan untuk baris sumber rekaman, perangkat mixer akan menggunakan jenis MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	Baris audio adalah sumber perekaman mikrofon. Sebagian besar kartu audio untuk komputer pribadi menyediakan setidaknya dua jenis sumber rekaman: saluran audio tambahan dan input mikrofon. Garis audio mikrofon biasanya memberikan semacam keuntungan. Kartu audio yang menggunakan input tunggal untuk digunakan dengan mikrofon atau garis audio tambahan harus menggunakan jenis komponen MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	Baris audio adalah sumber yang berasal dari speaker komputer pribadi. Beberapa kartu audio untuk komputer pribadi memberikan kemampuan untuk mencampur apa yang biasanya akan diputar pada speaker internal dengan output kartu audio. Beberapa kartu audio mendukung kemampuan untuk menggunakan output ini sebagai sumber perekaman.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	Baris audio adalah sumber yang berasal dari output synthesizer internal. Sebagian besar kartu audio untuk komputer pribadi menyediakan semacam synthesizer MIDI.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	Baris audio adalah sumber yang berasal dari saluran telepon masuk.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	Baris audio adalah sumber yang tidak dapat ditentukan oleh salah satu jenis komponen standar. Perangkat mixer diperlukan untuk menggunakan jenis komponen ini untuk jenis komponen garis yang belum ditentukan oleh Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	Baris audio adalah sumber yang berasal dari waveform-audio output digital-to-analog converter (DAC). Sebagian besar kartu audio untuk komputer pribadi menyediakan tipe komponen ini sebagai sumber ke tujuan MIXERLINE_COMPONENTTYPE_DST_SPEAKERS. Beberapa kartu juga memungkinkan sumber ini dirutekan ke tujuan MIXERLINE_COMPONENTTYPE_DST_WAVEIN.

cChannels

Jumlah maksimum saluran terpisah yang dapat dimanipulasi secara independen untuk baris audio. Nilai minimum untuk bidang ini adalah 1 karena baris harus memiliki setidaknya satu saluran.

Sebagian besar kartu audio modern untuk komputer pribadi adalah perangkat stereo; untuk mereka, nilai anggota ini adalah 2.

Saluran 1 diasumsikan sebagai saluran kiri; saluran 2 diasumsikan sebagai saluran yang tepat.

Garis multisaluran mungkin memiliki satu atau beberapa kontrol seragam (kontrol yang memengaruhi semua saluran garis secara seragam) yang terkait dengannya.

cConnections

Jumlah koneksi yang terkait dengan baris audio. Anggota ini hanya digunakan untuk baris tujuan audio dan menentukan jumlah baris sumber audio yang terkait dengannya. Anggota ini selalu nol untuk baris sumber dan untuk baris tujuan yang tidak memiliki baris sumber audio yang terkait dengannya.

cControls

Jumlah kontrol yang terkait dengan garis audio. Nilai ini bisa nol. Jika tidak ada kontrol yang terkait dengan garis, garis kemungkinan akan menjadi sumber yang mungkin dipilih dalam MIXERCONTROL_CONTROLTYPE_MUX atau MIXERCONTROL_CONTROLTYPE_MIXER tetapi tidak memungkinkan manipulasi sinyal.

szShortName[MIXER_SHORT_NAME_CHARS]

String pendek yang menjelaskan garis mixer audio yang ditentukan dalam anggota dwLineID. Deskripsi ini harus sesuai sebagai label ringkas untuk baris.

szName[MIXER_LONG_NAME_CHARS]

String yang menjelaskan garis mixer audio yang ditentukan dalam anggota dwLineID. Deskripsi ini harus sesuai sebagai deskripsi lengkap untuk baris.

Target

Informasi media target.

Target.dwType

Jenis perangkat media target yang terkait dengan baris audio yang dijelaskan dalam struktur MIXERLINE . Aplikasi harus mengabaikan informasi target untuk jenis perangkat media yang tidak digunakannya. Nilai berikut didefinisikan:

Nama	Deskripsi
MIXERLINE_TARGETTYPE_AUX	Baris audio yang dijelaskan oleh struktur MIXERLINE terikat secara ketat ke perangkat tambahan yang dirinci dalam anggota Target anggota struktur MIXERLINE.
MIXERLINE_TARGETTYPE_MIDIIN	Baris audio yang dijelaskan oleh struktur MIXERLINE terikat secara ketat ke perangkat input MIDI yang dirinci dalam anggota Target anggota struktur MIXERLINE.
MIXERLINE_TARGETTYPE_MIDIOUT	Baris audio yang dijelaskan oleh struktur MIXERLINE terikat secara ketat ke perangkat output MIDI yang dirinci dalam anggota struktur Target struktur MIXERLINE.
MIXERLINE_TARGETTYPE_UNDEFINED	Garis audio yang dijelaskan oleh struktur MIXERLINE tidak terikat secara ketat ke jenis media yang ditentukan. Semua anggota struktur Target yang tersisa dari struktur MIXERLINE harus diabaikan. Aplikasi tidak dapat menggunakan jenis target MIXERLINE_TARGETTYPE_UNDEFINED saat memanggil fungsi mixerGetLineInfo dengan bendera MIXER_GETLINEINFOF_TARGETTYPE.
MIXERLINE_TARGETTYPE_WAVEIN	Baris audio yang dijelaskan oleh struktur MIXERLINE terikat secara ketat ke perangkat input waveform-audio yang dirinci dalam anggota Target anggota struktur MIXERLINE struktur.
MIXERLINE_TARGETTYPE_WAVEOUT	Garis audio yang dijelaskan oleh struktur MIXERLINE terikat secara ketat ke perangkat output waveform-audio yang dirinci dalam anggota Target anggota struktur MIXERLINE.

Target.dwDeviceID

Pengidentifikasi perangkat perangkat saat ini dari perangkat media target ketika anggota dwType adalah jenis target selain MIXERLINE_TARGETTYPE_UNDEFINED. Pengidentifikasi ini identik dengan indeks perangkat media saat ini dari perangkat media terkait. Saat memanggil fungsi mixerGetLineInfo dengan bendera MIXER_GETLINEINFOF_TARGETTYPE, anggota ini diabaikan pada input dan akan dikembalikan ke pemanggil oleh manajer mixer audio.

Target.wMid

Pengidentifikasi produsen perangkat media target ketika anggota dwType adalah jenis target selain MIXERLINE_TARGETTYPE_UNDEFINED. Pengidentifikasi ini identik dengan wMid anggota struktur kemampuan perangkat untuk media terkait. Pengidentifikasi produsen didefinisikan dalam Produsen dan Pengidentifikasi Produk.

Target.wPid

Pengidentifikasi produk perangkat media target ketika anggota dwType adalah jenis target selain MIXERLINE_TARGETTYPE_UNDEFINED. Pengidentifikasi ini identik dengan wPid anggota struktur kemampuan perangkat untuk media terkait. Pengidentifikasi produk didefinisikan dalam Produsen dan Pengidentifikasi Produk.

Target.vDriverVersion

Versi driver perangkat media target ketika anggota dwType adalah jenis target selain MIXERLINE_TARGETTYPE_UNDEFINED. Versi ini identik dengan vDriverVersion anggota struktur kemampuan perangkat untuk media terkait.

Target.szPname[MAXPNAMELEN]

Nama produk perangkat media target saat anggota dwType adalah jenis target selain MIXERLINE_TARGETTYPE_UNDEFINED. Nama ini identik dengan szPname anggota struktur kemampuan perangkat untuk media terkait.

Komentar

Nota

Header mmeapi.h mendefinisikan MIXERLINE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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]
Header	mmeapi.h

Lihat juga

Struktur Mixer Audio

Mixer Audio

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo

Bagikan melalui