perintah MCI_SETAUDIO
Perintah MCI_SETAUDIO mengatur nilai yang terkait dengan pemutaran dan pengambilan audio. Perangkat digital-video dan VCR mengenali perintah ini.
Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SETAUDIO,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);
Parameter
-
wDeviceID
-
Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, atau MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.
-
lpSetAudio
-
Arahkan ke struktur MCI_GENERIC_PARMS . (Perangkat dengan set perintah yang diperluas mungkin mengganti struktur ini dengan struktur khusus perangkat.)
Tampilkan Nilai
Mengembalikan nol jika berhasil atau kesalahan sebaliknya.
Keterangan
Bendera berikut berlaku untuk jenis perangkat digitalvideo :
-
MCI_DGV_SETAUDIO_ALG
-
Anggota lpstrAlgorithm dari struktur yang diidentifikasi oleh lpSetAudio berisi alamat buffer yang berisi nama algoritma kompresi audio. Algoritma kompresi digunakan oleh perintah MCI_RESERVE atau MCI_RECORD berikutnya. Algoritma yang tersedia tergantung pada perangkat. Jika algoritma tidak kompatibel dengan format file saat ini, format file diubah ke format default untuk algoritma.
-
MCI_DGV_SETAUDIO_CLOCKTIME
-
Waktu yang ditentukan dalam milidetik dan merupakan waktu absolut saat digunakan dengan MCI_DGV_SETAUDIO_OVER. (Kali ini tidak selangkah dengan pemutaran ruang kerja.)
-
MCI_DGV_SETAUDIO_INPUT
-
Memodifikasi bass, treble, atau bendera volume sehingga memengaruhi sinyal input dan memodifikasi apa yang direkam. Jika memungkinkan, ini adalah default saat memantau input.
-
MCI_DGV_SETAUDIO_ITEM
-
Konstanta audio ditentukan dalam anggota dwItem dari struktur yang diidentifikasi oleh lpSetAudio. Konstanta mengidentifikasi nilai yang sedang ditetapkan. Konstanta berikut didefinisikan:
-
MCI_DGV_SETAUDIO_AVGBYTESPERSEC
-
Jumlah rata-rata byte ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Nilai ini menetapkan jumlah rata-rata byte per detik untuk memutar atau merekam dalam format PCM (Modulasi Kode Pulse) dan ADPCM (Modulasi Kode Pulse Diferensial Adaptif). File disimpan dalam format ini.
-
MCI_DGV_SETAUDIO_BASS
-
Tingkat frekuensi rendah audio ditentukan sebagai faktor dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio.
-
MCI_DGV_SETAUDIO_BITSPERSAMPLE
-
Jumlah bit per sampel ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Nilai ini menetapkan jumlah bit per sampel yang diputar atau direkam dalam format PCM. File disimpan dalam format ini.
-
MCI_DGV_SETAUDIO_BLOCKALIGN
-
Perataan blok data ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Nilai ini menetapkan perataan blok data relatif terhadap awal data bentuk gelombang input.
-
MCI_DGV_SETAUDIO_SAMPLESPERSEC
-
Laju sampel ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Nilai ini menetapkan laju sampel untuk bermain dan merekam dengan algoritma PCM dan ADPCM. File disimpan dalam format ini.
-
MCI_DGV_SETAUDIO_SOURCE
-
Konstanta yang menentukan sumber input audio disertakan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Konstanta berikut didefinisikan untuk sumber input audio:
MCI_DGV_SETAUDIO_SOURCE_AVERAGE
Rata-rata saluran audio kiri dan kanan.
MCI_DGV_SETAUDIO_SOURCE_LEFT
Saluran audio kiri.
MCI_DGV_SETAUDIO_SOURCE_RIGHT
Saluran audio kanan.
MCI_DGV_SETAUDIO_SOURCE_STEREO
Stereo.
-
MCI_DGV_SETAUDIO_STREAM
-
Aliran audio ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Nilai bilangan bulat menentukan aliran audio yang diputar kembali dari ruang kerja. Jika aliran tidak ditentukan, aliran audio pertama yang diselingi secara fisik diputar.
-
MCI_DGV_SETAUDIO_TREBLE
-
Tingkat frekuensi tinggi audio ditentukan sebagai faktor dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio.
-
MCI_DGV_SETAUDIO_VOLUME
-
Tingkat audio untuk satu atau kedua saluran audio ditentukan sebagai faktor dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Jika volume kiri dan kanan telah diatur ke nilai yang berbeda, rasio volume kiri ke kanan kira-kira tidak berubah.
-
MCI_DGV_SETAUDIO_LEFT
-
Mengaktifkan saluran audio kiri saat digunakan dengan MCI_SET_ON. Menonaktifkan saluran audio kiri saat digunakan dengan MCI_SET_OFF. Ketika bendera ini digunakan dengan kombinasi MCI_DGV_SETAUDIO_VALUE dan MCI_DGV_SETAUDIO_VOLUME, bendera ini mengatur volume saluran audio kiri. Ketika bendera ini digunakan dengan MCI_DGV_SETAUDIO_SOURCE, bendera menentukan saluran audio kiri sebagai sumber untuk digitizer input audio.
-
MCI_DGV_SETAUDIO_OVER
-
Parameter panjang transisi disertakan dalam anggota dwOver dari struktur yang diidentifikasi oleh lpSetAudio. Nilai panjang menentukan berapa lama (dalam satuan format waktu saat ini) yang diperlukan untuk membuat perubahan yang menggunakan faktor . Jika bendera ini tidak digunakan, perubahan akan segera terjadi.
-
MCI_DGV_SETAUDIO_QUALITY
-
Anggota lpstrQuality dari struktur yang diidentifikasi oleh lpSetAudio berisi alamat buffer yang menentukan kualitas audio. String teks dalam buffer menentukan karakteristik algoritma kompresi audio.
Bendera MCI_DGV_SETAUDIO_ALG dapat digunakan untuk memilih deskriptor kualitas untuk algoritma yang ditentukan. Jika bendera ini dihilangkan, maka algoritma saat ini digunakan.
Algoritma dan nama deskriptor yang tersedia bergantung pada perangkat. Setiap perangkat menyediakan dokumentasi untuk algoritma yang tersedia dan deskripsi nama deskriptor yang berlaku. Perintah MCI_QUALITY dapat menentukan nama deskriptor tambahan.
-
MCI_DGV_SETAUDIO_RECORD
-
Menentukan apakah rekaman menyertakan atau mengecualikan data audio. Saat dikombinasikan dengan MCI_SET_ON, data audio akan direkam. Saat dikombinasikan dengan MCI_SET_OFF, data audio dikecualikan. Defaultnya mencakup data audio.
-
MCI_DGV_SETAUDIO_RIGHT
-
Mengaktifkan saluran audio yang tepat saat digunakan dengan MCI_SET_ON. Menonaktifkan saluran audio yang tepat saat digunakan dengan MCI_SET_OFF. Ketika bendera ini digunakan dengan kombinasi MCI_DGV_SETAUDIO_VALUE dan MCI_DGV_SETAUDIO_VOLUME, bendera ini mengatur volume saluran audio yang tepat.
-
MCI_DGV_SETAUDIO_VALUE
-
Nilai ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetAudio. Arti nilai ditentukan oleh konstanta yang ditentukan untuk bendera MCI_DGV_SETAUDIO_ITEM.
-
MCI_SET_OFF
-
Menonaktifkan saluran audio yang ditentukan.
-
MCI_SET_ON
-
Mengaktifkan saluran audio yang ditentukan.
-
MCI_SETAUDIO_OUTPUT
-
Memodifikasi bass, treble, atau bendera volume sehingga hanya memodifikasi sinyal yang diputar dan bukan apa yang direkam. Jika memungkinkan, ini adalah default saat memantau input.
Untuk perangkat digital-video, parameter lpSetAudio menunjuk ke struktur MCI_DGV_SETAUDIO_PARMS .
Bendera tambahan berikut digunakan dengan jenis perangkat vcr :
-
MCI_VCR_SETAUDIO_RECORD
-
Mengatur perekaman audio ke aktif atau nonaktif, yang digunakan bersama dengan salah satu bendera berikut:
MCI_SET_ON
Rekaman audio aktif.
MCI_SET_OFF
Perekaman audio nonaktif. Mungkin perlu untuk terlebih dahulu menonaktifkan perekaman yang merakit (menggunakan perintah MCI_SET dengan bendera MCI_VCR_SET_ASSEMBLE_RECORD diatur ke nonaktif) sebelum rekaman audio dapat dinonaktifkan.
MCI_TRACK
Anggota dwTrack dari struktur yang diidentifikasi oleh lpSetAudio menentukan trek mana yang dipengaruhi oleh perintah.
MCI_VCR_SETAUDIO_SOURCE
Mengatur sumber audio. Bendera ini harus digunakan dengan bendera MCI_VCR_SETAUDIO_TO.
MCI_VCR_SETAUDIO_MONITOR
Mengatur monitor sumber audio. Bendera ini harus digunakan dengan bendera MCI_VCR_SETAUDIO_TO.
MCI_VCR_SETAUDIO_TO
Anggota dwTo dari struktur yang diidentifikasi oleh lpSetAudio berisi konstanta yang menjelaskan jenis input atau input yang dipantau. Ini harus salah satu dari yang berikut ini:
-
MCI_VCR_SRC_TYPE_TUNER
Jenisnya adalah tuner.
-
MCI_VCR_SRC_TYPE_LINE
Jenis adalah garis.
-
MCI_VCR_SRC_TYPE_AUX
Jenisnya tambahan.
-
MCI_VCR_SRC_TYPE_GENERIC
Jenisnya generik.
-
MCI_VCR_SRC_TYPE_MUTE
Jenis bisu. Ini hanya dapat digunakan dengan bendera MCI_VCR_SETAUDIO_SOURCE.
-
MCI_VCR_SRC_TYPE_OUTPUT
Jenis adalah output.
-
MCI_VCR_SETAUDIO_NUMBER
Anggota dwNumber dari struktur yang diidentifikasi oleh lpSetAudio berisi input audio (dari jenis yang ditentukan dalam anggota dwTo) untuk digunakan.
-
Untuk perangkat VCR, parameter lpSetAudio menunjuk ke struktur MCI_VCR_SETAUDIO_PARMS .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|