Struktur MIXERLINECONTROLS (mmeapi.h)

Struktur MIXERLINECONTROLS berisi informasi tentang kontrol garis audio.

Sintaks

typedef struct tMIXERLINECONTROLS {
  DWORD          cbStruct;
  DWORD          dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  };
  DWORD          cControls;
  DWORD          cbmxctrl;
  LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;

Anggota

cbStruct

Ukuran, dalam byte, dari struktur MIXERLINECONTROLS . Anggota ini harus diinisialisasi sebelum memanggil fungsi mixerGetLineControls . Ukuran yang ditentukan dalam anggota ini harus cukup besar untuk memuat struktur MIXERLINECONTROLS . Ketika mixerGetLineControls kembali, anggota ini berisi ukuran aktual informasi yang dikembalikan. Informasi yang dikembalikan tidak akan melebihi ukuran yang diminta, juga tidak akan lebih kecil dari struktur MIXERLINECONTROLS .

dwLineID

Pengidentifikasi garis yang kontrolnya sedang dikueri. Anggota ini tidak digunakan jika bendera MIXER_GETLINECONTROLSF_ONEBYID ditentukan untuk fungsi mixerGetLineControls , tetapi perangkat mixer masih mengembalikan anggota ini dalam hal ini. Anggota dwControlID dan dwControlType tidak digunakan saat MIXER_GETLINECONTROLSF_ALL ditentukan.

dwControlID

Mengontrol pengidentifikasi kontrol yang diinginkan. Anggota ini digunakan dengan bendera MIXER_GETLINECONTROLSF_ONEBYID untuk fungsi mixerGetLineControls untuk mengambil informasi kontrol kontrol yang ditentukan. Perhatikan bahwa anggota dwLineID dari struktur MIXERLINECONTROLS akan dikembalikan oleh perangkat mixer dan tidak diperlukan sebagai parameter input. Anggota ini tumpang tindih dengan anggota dwControlType dan tidak dapat digunakan bersama dengan jenis kueri MIXER_GETLINECONTROLSF_ONEBYTYPE.

dwControlType

Kelas Jenis Kontrol yang diinginkan. Anggota ini digunakan dengan bendera MIXER_GETLINECONTROLSF_ONEBYTYPE untuk fungsi mixerGetLineControls untuk mengambil kontrol pertama dari kelas yang ditentukan pada baris yang ditentukan oleh anggota dwLineID dari struktur MIXERLINECONTROLS . Anggota ini tumpang tindih dengan anggota dwControlID dan tidak dapat digunakan bersama dengan jenis kueri MIXER_GETLINECONTROLSF_ONEBYID. Lihat deskripsi anggota dwControlType di MIXERCONTROL.

cControls

Jumlah elemen struktur MIXERCONTROL yang akan diambil. Anggota ini harus diinisialisasi oleh aplikasi sebelum memanggil fungsi mixerGetLineControls . Anggota ini bisa 1 hanya jika MIXER_GETLINECONTROLSF_ONEBYID atau MIXER_GETLINECONTROLSF_ONEBYTYPE ditentukan atau nilai yang dikembalikan di anggota cControls struktur MIXERLINE yang dikembalikan untuk baris audio. Anggota ini tidak boleh nol. Jika garis audio menentukan bahwa garis audio tidak memiliki kontrol, mixerGetLineControls tidak boleh dipanggil.

cbmxctrl

Ukuran, dalam byte, dari satu struktur MIXERCONTROL . Ukuran yang ditentukan dalam anggota ini harus setidaknya cukup besar untuk memuat struktur MIXERCONTROL dasar. Ukuran total, dalam byte, yang diperlukan untuk buffer yang ditunjukkan oleh anggota pamxctrl adalah produk dari anggota cbmxctrl dan cControls dari struktur MIXERLINECONTROLS .

pamxctrl

Arahkan ke satu atau beberapa struktur MIXERCONTROL untuk menerima properti kontrol garis audio yang diminta. Anggota ini tidak boleh NULL dan harus diinisialisasi sebelum memanggil fungsi mixerGetLineControls . Setiap elemen array kontrol harus setidaknya cukup besar untuk berisi struktur MIXERCONTROL dasar. Anggota cbmxctrl harus menentukan ukuran, dalam byte, dari setiap elemen dalam array ini. Tidak ada inisialisasi buffer yang ditunjukkan oleh anggota ini yang diperlukan oleh aplikasi. Semua anggota diisi oleh perangkat mixer (termasuk anggota cbStruct dari setiap struktur MIXERCONTROL ) setelah berhasil kembali.

Persyaratan

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 Audio Mixer

Mixer Audio

MIXERCONTROL

MIXERLINE

mixerGetLineControls