perintah setaudio

Perintah setaudio mengatur nilai yang terkait dengan pemutaran dan pengambilan audio. Perangkat digital-video dan VCR mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendString dengan parameter lpszCommand yang ditetapkan sebagai berikut.

_stprintf_s(
  lpszCommand, 
  TEXT("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

Parameter

lpszDeviceID

Pengidentifikasi perangkat MCI. Pengidentifikasi atau alias ini ditetapkan saat perangkat dibuka.

lpszAudio

Benderai untuk pemutaran dan pengambilan audio. Tabel berikut mencantumkan jenis perangkat yang mengenali perintah setaudio dan bendera yang digunakan oleh setiap jenis.

Nilai	Makna	Makna
digitalvideo	algoritma algoritmapenyelarasan ke bass bilangan bulatuntuk memperhitungkan bitspersample untuk bit_count bytepersec ke input clocktime bilangan bulatkiri pada volume kiri untukmemperhitungkan output	selama deskriptorkualitas durasimerekam rekaman langsung pada volume kanan untuk memperhitungkan samplespersec ke sumber bilangan bulatke aliran nama sumberke treble angkauntuk memperhitungkanvolume faktor
Vcr	nonaktif pada monitor untuk mengetikkan rekaman nomordi luar trek rekaman track_number nonaktif	record on record track track_number on source to typenumber tracktrack_number off track track_number on

Tabel berikut mencantumkan bendera yang dapat ditentukan dalam parameter lpszAudio dan maknanya.

Nilai	Makna
algoritma algoritma	Memilih algoritma kompresi audio tertentu untuk digunakan oleh perintah cadangan atau rekaman berikutnya. Algoritma yang didukung adalah spesifik perangkat. MCI mendefinisikan nilai "g711", "g721", "g722", "g728", "pcm", "cdxa", "adpcm", dan "adpcm4e" untuk algoritma. Jika perangkat mendukung nama algoritma "pcm", "cdxa", dan "adpcm4e", perangkat mematuhi definisi standar. Algoritma "cdxa" telah didefinisikan oleh Sony Corporation. Algoritma "adpcm4e" telah ditentukan oleh Intel Corporation. Nilai "g711", "g721", "g722", dan "g728" mewakili algoritma audio yang direkomendasikan oleh International Telegraph and Telephone Consultative Committee (CCITT). Jika algoritma yang ditentukan bertentangan dengan format file saat ini, format file diubah ke format default untuk algoritma.
perataan ke bilangan bulat	Mengatur perataan blok data relatif terhadap awal data waveform-audio input.
bass ke faktor	Mengatur tingkat frekuensi rendah audio.
bitspersample ke bit_count	Mengatur jumlah bit per sampel yang direkam. File disimpan dalam format ini. Bendera ini hanya berlaku untuk perangkat yang mendukung algoritma "pcm".
bytepersec ke bilangan bulat	Mengatur jumlah rata-rata byte per detik untuk perekaman dalam algoritma "pcm" dan "adpcm". File disimpan dalam format ini.
clocktime	Menunjukkan waktu yang ditentukan dalam bendera "lebih" dalam milidetik. Kali ini bersifat absolut dan tidak selangkah dengan bermain ruang kerja.
input	Memodifikasi bendera "bass", "treble", atau "volume" sehingga memengaruhi sinyal input dan memodifikasi apa yang direkam. Jika memungkinkan, ini adalah default saat memantau input.
kiri kiri di	Mengaktifkan atau menonaktifkan output audio di saluran kiri. Sumber presentasi audio dapat menjadi input eksternal atau ruang kerja. Defaultnya adalah "left on". Jika hanya ada satu saluran, saluran tersebut diatur atau dinonaktifkan.
volume kiri ke faktor	Mengatur volume audio saluran audio kiri. Jika hanya ada satu saluran, ia mengatur volumenya.
pantau untuk mengetiknomor	Mengontrol input sumber mana yang akan diteruskan ke output VCR tanpa mengubah pilihan input sumber rekaman. Jenis dapat berupa "output", atau salah satu sumber input yang valid. Jika angka tidak ditentukan, input pertama dari jenis tersebut akan dipilih.
nonaktif pada	Mengaktifkan atau menonaktifkan audio. Sumber presentasi audio dapat berupa input eksternal atau ruang kerja. Perintah ini mempengaruhi saluran audio kiri dan kanan secara bersamaan. Defaultnya adalah setaudio "on".
output	Memodifikasi bendera "bass", "treble", atau "volume" sehingga hanya memodifikasi sinyal yang diputar dan bukan apa yang direkam. Jika memungkinkan, ini adalah default saat memantau file.
lebih dari durasi	Menentukan berapa lama waktu yang diperlukan untuk membuat perubahan yang menggunakan variabel faktor . Unit untuk durasi berada dalam format waktu saat ini. Perubahan terjadi pada langkah dengan pemutaran ruang kerja. Saat bermain ditangguhkan, perubahan juga ditangguhkan sampai pemutaran berlanjut. Jika "over" tidak ditentukan atau tidak didukung, perubahan akan segera terjadi.
deskriptor kualitas	Menentukan karakteristik pemadatan audio yang dilakukan saat audio direkam ke file. Semua perangkat mendukung tiga deskriptor "rendah", "sedang", dan "tinggi". Defaultnya adalah perangkat tertentu. Jika bendera "algoritma" tidak ditentukan, penyesuaian "kualitas" berlaku untuk algoritma saat ini. Perintah kualitas dapat digunakan untuk menentukan nama deskriptor tambahan.
rekam nonaktif	Menghapus pilihan sumber audio sehingga tidak ada audio yang akan direkam dengan perintah rekaman berikutnya.
rekam pada	Mengaktifkan perekaman data audio. Defaultnya adalah merekam data audio.
rekam trek track_number nonaktif	Menghapus pilihan sumber audio sehingga tidak ada audio yang akan direkam dengan perintah rekaman berikutnya. "Track" memungkinkan pemilihan trek independen. Trek 2 sesuai dengan trek PCM di Hi8. Jika "track" tidak ditentukan, nilai default 1 diasumsikan.
track_number trek rekaman aktif	Memilih sumber audio yang akan direkam dengan perintah rekaman berikutnya. "Track" memungkinkan pemilihan trek independen. Trek 2 sesuai dengan trek PCM di Hi8. Jika "track" tidak ditentukan, nilai default 1 diasumsikan.
langsung dari kanan pada	Mengaktifkan atau menonaktifkan output audio di saluran yang tepat. Sumber presentasi audio dapat menjadi input eksternal atau ruang kerja. Defaultnya adalah "right on". Jika hanya ada satu saluran, bendera ini tidak berpengaruh.
volume ke faktor yang tepat	Mengatur volume audio ke saluran audio yang tepat. Jika hanya ada satu saluran, itu tidak berpengaruh.
samplespersec ke bilangan bulat	Mengatur laju sampel untuk perekaman dengan algoritma "pcm" dan "adpcm". File disimpan dalam format ini.
sumber ke nama sumber	Menentukan sumber untuk digitizer input audio. Konstanta yang ditentukan untuk nama sumber meliputi: "kiri", "kanan", "rata-rata", dan "stereo". Tiga pertama menentukan rekaman monofonik menggunakan input kiri saja, input kanan saja, dan rata-rata dari dua input.
sumber untuk mengetiknomor	Memilih sumber audio yang akan direkam pada pita. Jenis harus "tuner", "line", "svideo", "aux", "generic", atau "mute".
streaming ke angka	Menentukan aliran audio yang diputar kembali dari ruang kerja. Jika aliran tidak ditentukan dan format file tidak menentukan default, maka aliran audio yang diselingi yang secara fisik pertama akan diputar.
melacak track_number nonaktif	Menonaktifkan trek individual.
lacak track_number aktif	Mengaktifkan trek individual.
treble ke faktor	Mengatur tingkat frekuensi tinggi audio.
volume ke faktor	Mengatur volume audio rata-rata untuk kedua saluran audio. Jika volume kiri dan kanan telah diatur ke nilai yang berbeda, rasio volume kiri ke kanan kira-kira tidak berubah.

lpszFlags

Dapat berupa "tunggu", "beri tahu", "uji", atau kombinasi ini. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Untuk perangkat VCR, menggunakan setaudio dengan bendera yang menonaktifkan trek individual ("lacak track_number nonaktif") dapat menyebabkan aplikasi Anda menerima pesan status yang menunjukkan bahwa perintah tidak dapat dilakukan. Beberapa VCR hanya dapat menonaktifkan kombinasi trek, bukan trek individual; misalnya, trek audio pertama dan trek video dari kaset video. Dalam hal ini, cukup gunakan setaudio dan setvideo untuk terus menonaktifkan trek lain yang membentuk kombinasi. Driver akan mematikan trek saat menerima perintah untuk mematikan trek terakhir dalam kombinasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]

Lihat juga

MCI

String Perintah MCI

record

Reserve

setvideo