Bagikan melalui

Struktur MIXERLINE (mmeapi.h)

  • Artikel

Struktur MIXERLINE menjelaskan status dan metrik garis audio.

Sintaks

typedef struct tMIXERLINE {
  DWORD  cbStruct;
  DWORD  dwDestination;
  DWORD  dwSource;
  DWORD  dwLineID;
  DWORD  fdwLine;
  DWORD  dwUser;
  DWORD  dwComponentType;
  DWORD  cChannels;
  DWORD  cConnections;
  DWORD  cControls;
  char   szShortName[MIXER_SHORT_NAME_CHARS];
  char   szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD   dwType;
    DWORD   dwDeviceID;
    WORD    wMid;
    WORD    wPid;
    VERSION vDriverVersion;
    char    szPname[MAXPNAMELEN];
  } Target;
} MIXERLINE, *PMIXERLINE, *LPMIXERLINE;

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 anggota cDestinations 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 anggota dwDestination dikembalikan.

dwSource

Indeks untuk baris sumber audio yang terkait dengan anggota dwDestination . Artinya, anggota ini menentukan baris sumber audio ke-nyang 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 anggota cConnections untuk baris tujuan audio yang diberikan dalam anggota dwDestination .

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

Status dan bendera dukungan untuk baris audio. Anggota ini selalu dikembalikan ke aplikasi dan tidak memerlukan inisialisasi.

Nama Deskripsi
MIXERLINE_LINEF_ACTIVE
 Garis 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 baris 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 garis 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
 Garis audio adalah tujuan digital (misalnya, input digital ke perangkat audio DAT atau CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES
 Garis audio adalah tujuan yang dapat disesuaikan (keuntungan dan/atau redaman) 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 rekaman 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 (perolehan dan/atau redaman) 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 baris yang belum ditentukan oleh Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN
 Baris audio adalah tujuan yang akan menjadi sumber rekaman 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 rekaman akhir untuk input waveform-audio (ADC). Baris ini biasanya memberikan semacam keuntungan atau redaman. Ini adalah jenis komponen umum untuk baris rekaman sebagian besar kartu audio untuk komputer pribadi.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG
 Baris audio adalah sumber analog (misalnya, output analog dari pita video-kaset).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY
 Baris audio adalah sumber yang berasal dari baris audio tambahan. Jenis baris ini dimaksudkan sebagai sumber dengan keuntungan atau redaman 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 yang 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 rekaman.
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 baris 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; bagi 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 garis.

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 tersebut.

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 tipe perangkat media yang tidak digunakannya. Nilai berikut didefinisikan:

Nama Deskripsi
MIXERLINE_TARGETTYPE_AUX
 Baris audio yang dijelaskan oleh struktur MIXERLINE benar-benar terikat pada perangkat tambahan yang dirinci dalam anggota struktur Target yang tersisa dari struktur MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIIN
 Baris audio yang dijelaskan oleh struktur MIXERLINE benar-benar terikat pada perangkat input MIDI yang dirinci dalam anggota struktur Target yang tersisa dari anggota struktur MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIOUT
 Baris audio yang dijelaskan oleh struktur MIXERLINE benar-benar terikat ke perangkat output MIDI yang dirinci dalam anggota yang tersisa dari anggota struktur Target dari struktur MIXERLINE .
MIXERLINE_TARGETTYPE_UNDEFINED
 Baris 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 benar-benar terikat pada perangkat input waveform-audio yang dirinci dalam anggota struktur Target yang tersisa dari struktur MIXERLINE .
MIXERLINE_TARGETTYPE_WAVEOUT
 Baris audio yang dijelaskan oleh struktur MIXERLINE benar-benar terikat pada perangkat output waveform-audio yang dirinci dalam anggota struktur Target yang tersisa dari struktur MIXERLINE .

Target.dwDeviceID

Pengidentifikasi 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 anggota wMid dari 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 anggota wPid dari 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 anggota vDriverVersion dari struktur kemampuan perangkat untuk media terkait.

Target.szPname[MAXPNAMELEN]

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

Persyaratan

Persyaratan 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