Struktur MIXERCONTROLW (mmeapi.h)

Artikel
08/24/2023

Struktur MIXERCONTROL menjelaskan status dan metrik kontrol tunggal untuk garis audio.

Sintaksis

typedef struct tagMIXERCONTROLW {
  DWORD cbStruct;
  DWORD dwControlID;
  DWORD dwControlType;
  DWORD fdwControl;
  DWORD cMultipleItems;
  WCHAR szShortName[MIXER_SHORT_NAME_CHARS];
  WCHAR szName[MIXER_LONG_NAME_CHARS];
  union {
    struct {
      LONG lMinimum;
      LONG lMaximum;
    } DUMMYSTRUCTNAME;
    struct {
      DWORD dwMinimum;
      DWORD dwMaximum;
    } DUMMYSTRUCTNAME2;
    DWORD dwReserved[6];
  } Bounds;
  union {
    DWORD cSteps;
    DWORD cbCustomData;
    DWORD dwReserved[6];
  } Metrics;
} MIXERCONTROLW, *PMIXERCONTROLW, *LPMIXERCONTROLW;

Anggota

cbStruct

Ukuran, dalam byte, dari struktur MIXERCONTROL .

dwControlID

Pengidentifikasi yang ditentukan mixer audio yang secara unik mengacu pada kontrol yang dijelaskan oleh struktur MIXERCONTROL. Pengidentifikasi ini dapat dalam format apa pun yang didukung oleh perangkat mixer. Aplikasi harus menggunakan pengidentifikasi ini hanya sebagai handel abstrak. Tidak ada dua kontrol untuk satu perangkat mixer yang dapat memiliki pengidentifikasi kontrol yang sama.

dwControlType

Kelas kontrol yang pengidentifikasinya ditentukan dalam dwControlID. Aplikasi harus menggunakan informasi ini untuk menampilkan kontrol yang sesuai untuk input dari pengguna. Aplikasi juga dapat menampilkan grafik yang disesuaikan berdasarkan kelas kontrol atau mencari kelas kontrol tertentu pada baris tertentu. Jika aplikasi tidak tahu tentang kelas kontrol, kontrol ini harus diabaikan. Ada delapan klasifikasi kelas kontrol, masing-masing dengan satu atau beberapa jenis kontrol standar:

Nama	Deskripsi
MIXERCONTROL_CT_CLASS_CUSTOM	MIXERCONTROL_CONTROLTYPE_CUSTOM
MIXERCONTROL_CT_CLASS_FADER	MIXERCONTROL_CONTROLTYPE_BASS MIXERCONTROL_CONTROLTYPE_EQUALIZER MIXERCONTROL_CONTROLTYPE_FADER MIXERCONTROL_CONTROLTYPE_TREBLE MIXERCONTROL_CONTROLTYPE_VOLUME
MIXERCONTROL_CT_CLASS_LIST	MIXERCONTROL_CONTROLTYPE_MIXER MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT MIXERCONTROL_CONTROLTYPE_MUX MIXERCONTROL_CONTROLTYPE_SINGLESELECT
MIXERCONTROL_CT_CLASS_METER	MIXERCONTROL_CONTROLTYPE_BOOLEANMETER MIXERCONTROL_CONTROLTYPE_PEAKMETER MIXERCONTROL_CONTROLTYPE_SIGNEDMETER MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER
MIXERCONTROL_CT_CLASS_NUMBER	MIXERCONTROL_CONTROLTYPE_DECIBELS MIXERCONTROL_CONTROLTYPE_PERCENT MIXERCONTROL_CONTROLTYPE_SIGNED MIXERCONTROL_CONTROLTYPE_UNSIGNED
MIXERCONTROL_CT_CLASS_SLIDER	MIXERCONTROL_CONTROLTYPE_PAN MIXERCONTROL_CONTROLTYPE_QSOUNDPAN MIXERCONTROL_CONTROLTYPE_SLIDER
MIXERCONTROL_CT_CLASS_SWITCH	MIXERCONTROL_CONTROLTYPE_BOOLEAN MIXERCONTROL_CONTROLTYPE_BUTTON MIXERCONTROL_CONTROLTYPE_LOUDNESS MIXERCONTROL_CONTROLTYPE_MONO MIXERCONTROL_CONTROLTYPE_MUTE MIXERCONTROL_CONTROLTYPE_ONOFF MIXERCONTROL_CONTROLTYPE_STEREOENH
MIXERCONTROL_CT_CLASS_TIME	MIXERCONTROL_CONTROLTYPE_MICROTIME MIXERCONTROL_CONTROLTYPE_MILLITIME

fdwControl

Bendera status dan dukungan untuk kontrol garis audio. Nilai berikut didefinisikan:

Nama	Deskripsi
MIXERCONTROL_CONTROLF_DISABLED	Kontrol dinonaktifkan, mungkin karena pengaturan lain untuk perangkat keras mixer, dan tidak dapat digunakan. Aplikasi dapat membaca pengaturan saat ini dari kontrol yang dinonaktifkan, tetapi tidak dapat menerapkan pengaturan.
MIXERCONTROL_CONTROLF_MULTIPLE	Kontrol memiliki dua pengaturan atau lebih per saluran. Ekualiser, misalnya, memerlukan bendera ini karena setiap pita frekuensi dapat diatur ke nilai yang berbeda. Equalizer yang mempengaruhi kedua saluran garis stereo dengan cara yang seragam juga akan menentukan bendera MIXERCONTROL_CONTROLF_UNIFORM.
MIXERCONTROL_CONTROLF_UNIFORM	Kontrol ini bertindak pada semua saluran garis multisaluran dengan cara yang seragam. Misalnya, kontrol yang mematikan suara kedua saluran garis stereo akan mengatur bendera ini. Sebagian besar kontrol MIXERCONTROL_CONTROLTYPE_MUX dan MIXERCONTROL_CONTROLTYPE_MIXER juga menentukan bendera MIXERCONTROL_CONTROLF_UNIFORM.

cMultipleItems

Jumlah item per saluran yang membentuk kontrol MIXERCONTROL_CONTROLF_MULTIPLE. Angka ini selalu dua atau lebih besar untuk kontrol beberapa item. Jika kontrol bukan kontrol multi-item, jangan gunakan anggota ini; itu akan menjadi nol.

szShortName[MIXER_SHORT_NAME_CHARS]

String pendek yang menjelaskan kontrol garis audio yang ditentukan oleh dwControlID. Deskripsi ini harus sesuai untuk digunakan sebagai label ringkas untuk kontrol.

szName[MIXER_LONG_NAME_CHARS]

String yang menjelaskan kontrol garis audio yang ditentukan oleh dwControlID. Deskripsi ini harus sesuai untuk digunakan sebagai deskripsi lengkap untuk kontrol.

Bounds

Penyatuan jenis batas.

Bounds.DUMMYSTRUCTNAME

Bounds.DUMMYSTRUCTNAME.lMinimum

Nilai minimum yang ditandatangani untuk kontrol yang memiliki sifat batas yang ditandatangani. Anggota ini tidak dapat digunakan bersama dengan dwMinimum.

Bounds.DUMMYSTRUCTNAME.lMaximum

Nilai maksimum yang ditandatangani untuk kontrol yang memiliki sifat batas yang ditandatangani. Anggota ini tidak dapat digunakan bersama dengan dwMaximum.

Bounds.DUMMYSTRUCTNAME2

Bounds.DUMMYSTRUCTNAME2.dwMinimum

Nilai minimum yang tidak ditandatangani untuk kontrol yang memiliki sifat batas yang tidak ditandatangani. Anggota ini tidak dapat digunakan bersama dengan lMinimum.

Bounds.DUMMYSTRUCTNAME2.dwMaximum

Nilai maksimum yang tidak ditandatangani untuk kontrol yang memiliki sifat batas yang tidak ditandatangani. Anggota ini tidak dapat digunakan bersama dengan lMaximum.

Bounds.dwReserved[6]

Dipesan; jangan gunakan.

Metrics

Penyatuan metrik batas.

Metrics.cSteps

Jumlah rentang diskrit dalam gabungan yang ditentukan untuk kontrol yang ditentukan oleh anggota Batas . Anggota ini tumpang tindih dengan anggota lain dari Metrik anggota struktur dan tidak dapat digunakan bersama dengan anggota tersebut.

Metrics.cbCustomData

Ukuran, dalam byte, diperlukan untuk berisi status kelas kontrol kustom. Anggota ini hanya sesuai untuk kelas kontrol MIXERCONTROL_CONTROLTYPE_CUSTOM.

Metrics.dwReserved[6]

Dipesan; jangan gunakan.

Komentar

Nota

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

MIXERLINECONTROLS

mixerGetLineControls

Bagikan melalui