atur perintah

  • Artikel

Catatan

Komunikasi Bebas Bias Microsoft mendukung lingkungan yang beragam dan inklusioner. Dalam dokumen ini, ada referensi ke kata 'budak.' Panduan Gaya Microsoft untuk komunikasi Bias-Free mengenali ini sebagai kata pengecualian. Kata-kata ini digunakan karena saat ini adalah kata-kata yang digunakan dalam perintah. Untuk konsistensi, dokumen ini berisi kata ini. Ketika kata ini diubah dalam perintah, kita akan memperbaiki dokumen ini agar selaras.

Perintah set menetapkan pengaturan kontrol untuk perangkat. Audio CD, digital-video, sequencer MIDI, VCR, videodisc, video-overlay, dan perangkat waveform-audio mengenali perintah ini.

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

_stprintf_s(
  lpszCommand,
  TEXT("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);

Parameter

lpszDeviceID

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

lpszSetting

Bendera untuk membuat pengaturan kontrol. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah set dan bendera yang digunakan oleh setiap jenis.

Jenis Perangkat Bendera Perintah
cdaudio
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • pintu tertutup
  • pintu terbuka
  • format waktu milidetik
  • format waktu msf
  • format waktu tmsf
digitalvideo
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • pintu tertutup
  • pintu terbuka
  • format format file
  • cari tepat pada
  • cari persis off
  • faktor kecepatan
  • format file masih
  • kerangka format waktu
  • format waktu milidetik
  • video nonaktif
  • video pada
Overlay
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • pintu tertutup
  • pintu terbuka
  • video nonaktif
  • video pada
Sequencer
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • pintu tertutup
  • pintu terbuka
  • master MIDI
  • master tidak ada
  • master SMPTE
  • waktu offset
  • pemeta port
  • port tidak ada
  • port port_number
  • file slave
  • budak MIDI
  • budak tidak ada
  • slave SMPTE
  • tempo_value tempo
  • format waktu milidetik
  • format waktu SMPTE fps
  • format waktu SMPTE 30 drop
  • penunjuk lagu format waktu
Vcr
  • merakit rekaman pada
  • merakit rekaman nonaktif
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • waktu jam
  • format penghitung
  • nilai penghitung
  • pintu tertutup
  • pintu terbuka
  • penghitung indeks
  • tanggal indeks
  • waktu indeks
  • waktu indeks
  • durasi codelength
  • jeda waktu habis
  • durasi postroll -
  • durasi
  • nyalakan daya
  • matikan daya
  • durasi pra-pendaftaran
  • format rekaman SP
  • LP format rekaman
  • EP format rekaman
  • faktor kecepatan
  • kerangka format waktu
  • format waktu hms
  • format waktu milidetik
  • format waktu msf
  • format waktu SMPTE fps
  • format waktu SMPTE 30 drop
  • format waktu tmsf
  • penghitung mode waktu
  • deteksi mode waktu
  • kode waktu mode waktu
  • plus pelacakan
  • pelacakan minus
  • pelacakan reset
videodisc
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • pintu tertutup
  • pintu terbuka
  • kerangka format waktu
  • format waktu hms
  • format waktu milidetik
  • trek format waktu
  • video nonaktif
  • video pada
waveaudio
  • bilangan bulat perataan
  • input apa pun
  • output apa pun
  • audio semua nonaktif
  • audio semua aktif
  • audio ditinggalkan
  • audio dibiarkan hidup
  • audio langsung mati
  • audio ke kanan pada
  • bitspersample bit_count
  • bytepersec byte_rate
  • saluran channel_count
  • pintu tertutup
  • pintu terbuka
  • format tag pcm
  • tag format
  • bilangan bulat input
  • bilangan bulat output
  • bilangan bulat samplespersec
  • byte format waktu
  • format waktu milidetik
  • sampel format waktu

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

Nilai Makna
bilangan bulat perataan Mengatur perataan blok data relatif terhadap awal data yang diteruskan ke perangkat waveform-audio. File disimpan dalam format ini.
input apa pun Gunakan input apa pun yang mendukung format saat ini saat merekam. Ini adalah pengaturan default.
output apa pun Gunakan output apa pun yang mendukung format saat ini saat memutar. Ini adalah default.
merakit rekaman pada
merakit rekaman nonaktif
 Dalam mode merakit, semua trek direkam seperti yang didefinisikan oleh perangkat. Sebagian besar VCR berada dalam mode merakit secara default.
audio semua nonaktif
audio semua aktif
 Menonaktifkan atau mengaktifkan output audio. Perangkat video-overlay, pengurut MCISEQ, dan perangkat waveform-audio MCIWAVE tidak mendukung bendera ini.
audio ditinggalkan
audio dibiarkan hidup
audio langsung mati
audio ke kanan pada
 Menonaktifkan atau mengaktifkan output ke saluran audio kiri atau kanan. Perangkat video-overlay, pengurut MCISEQ, dan perangkat waveform-audio MCIWAVE tidak mendukung bendera ini.
bitspersample bit_count Mengatur jumlah bit per sampel PCM (Modulasi Kode Pulse) yang diputar atau direkam. File disimpan dalam format ini.
bytepersec byte_rate Mengatur jumlah rata-rata byte per detik yang diputar atau direkam. File disimpan dalam format ini.
saluran channel_count Mengatur saluran untuk diputar dan direkam. File disimpan dalam format ini.
waktu jam Mengatur waktu pada jam eksternal ke waktu. Format ditentukan sebagai bilangan bulat panjang yang tidak ditandatangani.
format penghitung Atur format waktu untuk penghitung, seperti yang dikembalikan oleh status "penghitung". Untuk informasi tentang jenis yang berlaku, lihat perintah atur "format waktu".
nilai penghitung Mengatur penghitung VCR ke nilai yang ditentukan. Nilai harus ditentukan dalam format penghitung saat ini. Untuk informasi selengkapnya, lihat perintah "format penghitung" yang ditetapkan .
pintu tertutup Mencabut baki dan menutup pintu, jika memungkinkan. Untuk VCR, memuat pita secara otomatis.
pintu terbuka Membuka pintu dan mengeluarkan baki atau pita, jika memungkinkan.
format file Menentukan format file yang digunakan untuk menyimpan atau mengambil perintah. Jika dihilangkan, ini mungkin default ke format yang ditentukan driver perangkat. Jika format file yang ditentukan berkonflik dengan algoritma dan kualitas yang saat ini dipilih, maka format tersebut diubah ke default untuk format file. Format file berikut didefinisikan:
  • avi: Menentukan format AVI.
  • avss: Menentukan format AVSS.
  • dib: Menentukan format DIB.
  • jfif: Menentukan format JFIF.
  • jpeg: Menentukan format JPEG.
  • mpeg: Menentukan format MPEG.
  • rdib: Menentukan format RLE DIB.
  • rjpeg: Menentukan format RJPEG.
format tag pcm Mengatur jenis format ke PCM untuk diputar dan direkam. File disimpan dalam format ini.
tag format Mengatur jenis format untuk memutar dan merekam. File disimpan dalam format ini.
kode waktu indeks
penghitung indeks
tanggal indeks
waktu indeks
 Mengatur layar tampilan saat ini pada VCR.
bilangan bulat input Mengatur saluran audio yang digunakan sebagai input.
durasi panjang Mengatur panjang pita yang ditentukan pengguna di VCR. Panjang ini dikembalikan oleh perintah "panjang" status dan disediakan untuk kompatibilitas dengan aplikasi yang mengharuskan perintah ini mengembalikan panjang yang valid.
master midi Mengatur pengurut MIDI sebagai sumber sinkronisasi. Data sinkronisasi dikirim dalam format MIDI. Sequencer MCISEQ tidak mendukung bendera ini.
master tidak ada Menghambat pengurut MIDI mengirim data sinkronisasi. Sequencer MCISEQ tidak mendukung bendera ini.
master smpte Mengatur pengurut MIDI sebagai sumber sinkronisasi. Data sinkronisasi dikirim dalam format SMPTE (Society of Motion Picture and Television Engineers). Sequencer MCISEQ tidak mendukung bendera ini.
waktu offset Mengatur waktu offset SMPTE. Offset adalah waktu awal urutan berbasis SMPTE. Waktu dinyatakan sebagai hh: mm: ss: ff, di mana hh adalah jam, mm adalah menit, ss adalah detik, dan ff adalah bingkai.
bilangan bulat output Mengatur saluran audio yang digunakan sebagai output.
jeda waktu habis Mengatur durasi maksimum, dalam milidetik, dari perintah jeda . Nilai batas waktu nol menunjukkan bahwa tidak ada waktu habis yang akan terjadi.
durasi postroll Mengatur panjang, dalam format waktu saat ini, diperlukan untuk mengerem transportasi VCR saat perintah berhenti atau jeda dikeluarkan.
pemeta port Mengatur pemeta MIDI sebagai port yang menerima pesan MIDI. Perintah ini gagal jika pemeta MIDI atau port yang dibutuhkan sedang digunakan oleh aplikasi lain.
port tidak ada Menonaktifkan pengiriman pesan MIDI. Perintah ini juga menutup port MIDI.
port port_number Mengatur port MIDI yang menerima pesan MIDI. Perintah ini gagal jika port yang coba Anda buka sedang digunakan oleh aplikasi lain.
nyalakan daya
matikan daya
 Mengatur daya perangkat ke aktif atau nonaktif.
durasi pra-pendaftaran Mengatur panjang, dalam format waktu saat ini, diperlukan untuk menstabilkan output VCR.
format rekaman SP
format rekaman LP
rekaman format EP
 Mengatur mode perekaman untuk VCR ke SP untuk pemutaran standar, EP untuk pemutaran yang diperpanjang, atau LP untuk pemutaran panjang. Nilai-nilai ini tidak dimaksudkan untuk spesifik VHS. Mereka memetakan ke tiga mode yang sesuai dengan format pita lainnya. Misalnya, SP memetakan ke rekaman kualitas tercepat dan tertinggi.
bilangan bulat samplespersec Mengatur laju sampel untuk pemutaran dan perekaman. File disimpan dalam format ini.
cari tepat pada
cari persis off
 Memilih salah satu dari dua mode pencarian. Dengan "cari tepat pada", pencarian akan selalu berpindah ke bingkai yang ditentukan. Dengan "cari persis tidak aktif", pencarian akan berpindah ke bingkai kunci terdekat sebelum bingkai yang ditentukan.
file slave Mengatur pengurut MIDI untuk menggunakan data file sebagai sumber sinkronisasi. Ini adalah pengaturan default.
budak midi Mengatur pengurut MIDI untuk menggunakan data MIDI masuk untuk sumber sinkronisasi. Pengurut mengenali data sinkronisasi dengan format MIDI. Sequencer MCISEQ tidak mendukung bendera ini.
budak tidak ada Mengatur pengurut MIDI untuk mengabaikan sinkronisasi
slave smpte Mengatur pengurut MIDI untuk menggunakan data MIDI masuk untuk sumber sinkronisasi. Pengurut mengenali data sinkronisasi dengan format SMPTE. Sequencer MCISEQ tidak mendukung bendera ini.
faktor kecepatan Mengatur kecepatan relatif pemutaran video dan audio dari ruang kerja. Faktor adalah rasio antara kecepatan bingkai nominal dan kecepatan bingkai yang diinginkan, di mana kecepatan bingkai nominal ditetapkan sebagai 1000. (Tingkat 500 adalah setengah kecepatan normal, 2000 adalah kecepatan normal dua kali, dan sebagainya.) Mengatur kecepatan ke nol memutar video secepat mungkin tanpa menghilangkan bingkai dan tanpa audio.
format file masih Menentukan format file yang digunakan untuk perintah pengambilan.
tempo_value tempo Mengatur tempo urutan sesuai dengan format waktu saat ini. Untuk file berbasis PPQN, tempo_value ditafsirkan sebagai ketukan per menit. Untuk file berbasis SMPTE, tempo_value ditafsirkan sebagai bingkai per detik.
byte format waktu Dalam format file PCM, mengatur format waktu ke byte. Semua informasi posisi ditentukan sebagai byte mengikuti perintah ini.
kerangka format waktu Mengatur format waktu ke bingkai. Semua perintah yang menggunakan nilai posisi akan mengasumsikan bingkai. Saat perangkat dibuka, bingkai adalah mode default. Didukung oleh videodiscs menggunakan format CAV.
format waktu hms Mengatur format waktu ke jam, menit, dan detik. Semua perintah yang menggunakan nilai posisi akan mengasumsikan HMS. HMS adalah format default untuk videodisc CLV. Tentukan nilai HMS sebagai hh:mm:ss, di mana hh adalah jam, mm adalah menit, dan ss adalah detik. Anda dapat menghilangkan bidang jika bidang dan semua bidang berikut adalah nol. Misalnya, 3, 3:0, dan 3:0:0 adalah cara yang valid untuk mengekspresikan 3 jam.
format waktu milidetik Mengatur format waktu ke milidetik. Semua perintah yang menggunakan nilai posisi akan mengasumsikan milidetik. Anda dapat singkatan milidetik sebagai "ms". Untuk perangkat pengurut, file urutan mengatur format default ke PPQN atau SMPTE. Perangkat video-overlay tidak mendukung bendera ini.
format waktu msf Mengatur format waktu ke menit, detik, dan bingkai. Semua perintah yang menggunakan nilai posisi akan mengasumsikan MSF (format default untuk audio CD). Tentukan nilai MSF sebagai mm:ss:ff, di mana mm adalah menit, ss adalah detik, dan ff adalah bingkai. Anda dapat menghilangkan bidang jika bidang dan semua bidang berikut adalah nol. Misalnya, 3, 3:0, dan 3:0:0 adalah cara yang valid untuk mengekspresikan 3 menit.
Bidang MSF memiliki nilai maksimum berikut:
  • Menit 99
  • Detik 59
  • Bingkai 74
sampel format waktu Mengatur format waktu ke sampel. Semua informasi posisi ditentukan sebagai sampel mengikuti perintah ini.
format waktu smpte 24
format waktu smpte 25
format waktu smpte 30
 Mengatur format waktu ke kecepatan bingkai SMPTE. Untuk VCR, mengatur format waktu ke hh:mm:ss:ff, di mana nilai hukum adalah 00:00:00:00 hingga 23:59:59:xx, dan xx kurang dari bingkai per detik seperti yang ditentukan oleh angka 24, 25, atau 30 seperti yang ditentukan dalam bendera. Pada input, titik dua (:) diperlukan untuk memisahkan komponen. Unit yang paling tidak signifikan dapat dihilangkan jika berjumlah 00; misalnya, 02:00 sama dengan 02:00:00:00. Semua perintah yang menggunakan nilai posisi akan mengasumsikan format SMPTE.
File urutan mengatur format default ke PPQN atau SMPTE.
format waktu smpte 30 drop Mengatur format waktu ke kecepatan bingkai penurunan SMPTE 30. Untuk VCR, sama seperti SMPTE 30, kecuali bahwa posisi kode waktu tertentu dihilangkan dari format untuk memiliki posisi kode waktu yang direkam untuk setiap bingkai (pada kecepatan bingkai NTSC 29,97 fps) sesuai dengan real time (pada 30 fps). Posisi kode waktu yang dihilangkan adalah sebagai berikut: dua setiap menit, pada menit, untuk sembilan pertama dari setiap sepuluh menit konten yang direkam. Misalnya, pada 01:04:59:29, posisi kode waktu berikutnya adalah 01:05:00:02, bukan 01:05:00:00. Semua perintah yang menggunakan nilai posisi akan mengasumsikan format SMPTE.
File urutan mengatur format default ke PPQN atau SMPTE.
penunjuk lagu format waktu Mengatur format waktu ke penunjuk lagu (catatan keenam belas). Semua perintah yang menggunakan nilai posisi akan mengasumsikan unit penunjuk lagu. Bendera ini hanya berlaku untuk urutan jenis pembagian PPQN.
format waktu tmsf Mengatur format waktu ke trek, menit, detik, dan bingkai. Semua perintah yang menggunakan nilai posisi akan mengasumsikan TMSF. Tentukan nilai TMSF sebagai tt:mm:ss:ff, di mana tt adalah trek, mm adalah menit, ss adalah detik, dan ff adalah bingkai. Anda dapat menghilangkan bidang jika bidang dan semua bidang berikut adalah nol. Misalnya, 3, 3:0, 3:0:0, dan 3:0:0:0 adalah cara yang valid untuk mengekspresikan trek 3.
Bidang TMSF memiliki nilai maksimum berikut:
  • Trek 99
  • Menit 90
  • Detik 59
  • Bingkai 74
trek format waktu Mengatur format posisi ke trek. Semua perintah yang menggunakan nilai posisi akan mengasumsikan trek.
penghitung mode waktu Mengatur mode informasi posisi untuk menggunakan penghitung VCR.
deteksi mode waktu Mengatur mode informasi posisi berdasarkan deteksi informasi kode waktu pada pita. Jika informasi kode waktu terdeteksi, jenis waktu diatur ke "kode waktu"; jika tidak, jenis waktu diatur ke "penghitung". "Deteksi" adalah mode khusus. Setiap kali driver dibuka, pita baru dimasukkan, atau perintah "mode waktu" dikeluarkan, driver memeriksa mode waktu saat ini yang tersedia pada pita dan mengatur "jenis waktu" ke "timecode" atau "penghitung". Setelah "jenis waktu" diatur, driver tidak mengubahnya sampai salah satu kondisi di atas terjadi lagi.
kode waktu mode waktu Mengatur mode informasi posisi untuk menggunakan informasi "kode waktu" pada pita.
plus pelacakan
pelacakan minus
pelacakan reset
 Menyesuaikan kecepatan transportasi rekaman video dengan kenaikan halus. Gunakan bendera "pelacakan" saat gambar berisik diperoleh dari VCR. "Tracking plus" meningkatkan kecepatan transportasi. "Pelacakan minus" mengurangi kecepatan transportasi. "Reset pelacakan" mengembalikan penyesuaian pelacakan ke nol.
video nonaktif Menonaktifkan output video.
video pada Mengaktifkan output video.

lpszFlags

Bisa "tunggu", "beri tahu", atau keduanya. Untuk perangkat digital-video dan VCR, "pengujian" juga dapat ditentukan. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Beberapa properti data waveform-audio ditentukan saat file untuk menyimpan data dibuat. Properti ini menjelaskan bagaimana data disusun dalam file dan tidak dapat diubah setelah perekaman dimulai. Daftar berikut mengidentifikasi properti ini:

  • Alignment
  • bitspersample
  • bytepersec
  • channels
  • format tag
  • samplespersec

Contoh

Perintah berikut mengatur format waktu ke milidetik dan mengatur format waveform-audio ke 8 bit, mono, 11 kHz.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

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

Menangkap

Jeda

Menyimpan

stop