perintah MCI_SET
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 MCI_SET mengatur informasi perangkat. Audio CD, digital-video, sequencer MIDI, VCR, videodisc, video-overlay, dan perangkat waveform-audio mengenali perintah ini.
Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SET,
DWORD dwFlags,
(DWORD) (LPMCI_SET_PARMS) lpSet
);
Parameter
-
wDeviceID
-
Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, atau, untuk perangkat digital-video dan VCR, MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.
-
lpSet
-
Penunjuk ke struktur MCI_SET_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 tambahan berikut berlaku untuk semua perangkat yang mendukung MCI_SET:
-
MCI_SET_AUDIO
-
Nomor saluran audio disertakan dalam anggota struktur dwAudio yang diidentifikasi oleh lpSet. Bendera ini harus digunakan dengan MCI_SET_ON atau MCI_SET_OFF. Gunakan salah satu konstanta berikut untuk menunjukkan nomor saluran:
-
MCI_SET_AUDIO_ALL
-
Semua saluran audio.
-
MCI_SET_AUDIO_LEFT
-
Saluran kiri.
-
MCI_SET_AUDIO_RIGHT
-
Saluran kanan.
-
MCI_SET_DOOR_CLOSED
-
Menutup sampul media (jika ada).
-
MCI_SET_DOOR_OPEN
-
Membuka sampul media (jika ada).
-
MCI_SET_OFF
-
Menonaktifkan saluran video atau audio yang ditentukan.
-
MCI_SET_ON
-
Mengaktifkan saluran video atau audio yang ditentukan.
-
MCI_SET_TIME_FORMAT
-
Parameter format waktu disertakan dalam anggota dwTimeFormat dari struktur yang diidentifikasi oleh lpSet. Bendera berikut digunakan dengan bendera ini:
-
MCI_FORMAT_BYTES
-
Dalam format data PCM (Modulasi Kode Pulse), ubah deskripsi anggota waktu menjadi byte untuk input atau output. Dikenali oleh jenis perangkat waveaudio .
-
MCI_FORMAT_FRAMES
-
Perintah berikutnya akan menggunakan bingkai. Dikenali oleh jenis perangkat digitalvideo, vcr, dan videodisc .
-
MCI_FORMAT_HMS
-
Mengubah format waktu menjadi jam, menit, dan detik. Dikenali oleh jenis perangkat vcr dan videodisc .
-
MCI_FORMAT_MILLISECONDS
-
Mengubah format waktu menjadi milidetik. Dikenali oleh semua jenis perangkat.
-
MCI_FORMAT_MSF
-
Mengubah format waktu menjadi menit, detik, dan bingkai. Diakui oleh jenis perangkat cdaudio dan vcr .
-
MCI_FORMAT_SAMPLES
-
Mengubah format waktu menjadi sampel untuk input atau output. Dikenali oleh jenis perangkat waveaudio .
-
MCI_FORMAT_SMPTE_24, MCI_FORMAT_SMPTE_25, dan MCI_FORMAT_SMPTE_30
-
Mengatur format waktu menjadi 24, 25, dan 30 bingkai SMPTE (Society of Motion Picture dan Television Engineers), masing-masing. Dikenali oleh jenis perangkat sequencer dan vcr .
-
MCI_FORMAT_SMPTE_30DROP
-
Mengatur format waktu ke 30 SMPTE drop-frame. Dikenali oleh jenis perangkat sequencer dan vcr .
-
MCI_FORMAT_TMSF
-
Mengubah format waktu menjadi trek, menit, detik, dan bingkai. (MCI menggunakan nomor trek berkelanjutan.) Diakui oleh jenis perangkat cdaudio dan vcr .
-
MCI_SET_VIDEO
-
Mengatur sinyal video aktif atau nonaktif. Bendera ini harus digunakan dengan MCI_SET_ON atau MCI_SET_OFF. Perangkat yang tidak memiliki MCIERR_UNSUPPORTED_FUNCTION pengembalian video.
Bendera tambahan berikut digunakan dengan jenis perangkat digitalvideo :
-
MCI_DGV_SET_FILEFORMAT
-
Parameter format file disertakan dalam anggota dwFileFormat dari struktur yang diidentifikasi oleh lpSet. Untuk perangkat digital-video, format file 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 file tersebut diubah ke default untuk format file. Konstanta format file berikut didefinisikan:
-
MCI_DGV_FF_AVI
-
Format AVI.
-
MCI_DGV_FF_AVSS
-
Format AVSS.
-
MCI_DGV_FF_DIB
-
Format DIB.
-
MCI_DGV_FF_JFIF
-
Format JFIF.
-
MCI_DGV_FF_JPEG
-
Format JPEG.
-
MCI_DGV_FF_MPEG
-
Format MPEG.
-
MCI_DGV_FF_RDIB
-
Format RLE DIB.
-
MCI_DGV_FF_RJPEG
-
Format RJPEG.
-
MCI_DGV_SET_SEEK_EXACTLY
-
Mengatur format yang digunakan untuk penempatan. Bendera ini harus digunakan dengan MCI_SET_ON atau MCI_SET_OFF. Jika MCI_SET_ON ditentukan, memutar atau merekam dengan tepat mengakses bingkai yang ditentukan dengan bendera MCI_FROM. Ini mungkin menambahkan beberapa penundaan tambahan jika bingkai yang diminta bukan bingkai kunci. Jika MCI_SET_OFF ditentukan, perangkat akan mencari gambar bingkai kunci yang mendahului bingkai yang diminta. Untuk beberapa file dan perangkat, ini mungkin bingkai pertama file. Default untuk bendera ini tergantung pada perangkat.
-
MCI_DGV_SET_SPEED
-
Parameter kecepatan disertakan dalam anggota dwSpeed dari struktur yang diidentifikasi oleh lpSet. Kecepatan ditentukan sebagai rasio antara kecepatan bingkai nominal dan kecepatan bingkai yang diinginkan di mana kecepatan bingkai nominal ditetapkan sebagai 1000. Kecepatan setengah adalah 500 dan kecepatan ganda adalah 2000. Rentang kecepatan yang diizinkan tergantung pada perangkat dan mungkin file juga.
-
MCI_DGV_SET_STILL
-
Saat digunakan dengan MCI_DGV_SET_FILEFORMAT, MCI_SET mengatur format file yang digunakan untuk perintah pengambilan.
Untuk perangkat video digital, parameter lpSet menunjuk ke struktur MCI_DGV_SET_PARMS .
Bendera tambahan berikut digunakan dengan jenis perangkat sequencer :
-
MCI_SEQ_FORMAT_SONGPTR
-
Mengatur format waktu ke unit penunjuk lagu.
-
MCI_SEQ_SET_MASTER
-
Mengatur pengurut sebagai sumber data sinkronisasi dan menunjukkan bahwa jenis sinkronisasi ditentukan dalam anggota dwMaster struktur yang diidentifikasi oleh lpSet. MCISEQ mengembalikan MCIERR_UNSUPPORTED_FUNCTION. Konstanta berikut didefinisikan untuk jenis sinkronisasi:
-
MCI_SEQ_MIDI
-
Pengurut akan mengirim data sinkronisasi format MIDI.
-
MCI_SEQ_SMPTE
-
Pengurut akan mengirim data sinkronisasi format SMPTE.
-
MCI_SEQ_NONE
-
Pengurut tidak akan mengirim data sinkronisasi.
-
MCI_SEQ_SET_OFFSET
-
Mengubah offset SMPTE dari urutan ke yang ditentukan oleh anggota dwOffset struktur yang diidentifikasi oleh lpSet. Ini hanya memengaruhi urutan dengan jenis divisi SMPTE.
-
MCI_SEQ_SET_PORT
-
Mengatur port MIDI output dari urutan ke yang ditentukan oleh pengidentifikasi perangkat MIDI di anggota dwPort struktur yang diidentifikasi oleh lpSet. Perangkat menutup port sebelumnya (jika ada), dan mencoba membuka dan menggunakan port baru. Jika gagal, ia mengembalikan kesalahan dan membuka kembali port yang digunakan sebelumnya (jika ada). Konstanta berikut didefinisikan untuk port:
-
MCI_SEQ_NONE
-
Menutup port yang sebelumnya digunakan (jika ada). Pengurut bersifat persis sama seolah-olah port terbuka, kecuali tidak ada pesan MIDI yang dikirim.
-
MIDI_MAPPER
-
Mengatur port yang dibuka ke pemeta MIDI.
-
MCI_SEQ_SET_SLAVE
-
Mengatur pengurut untuk menerima data sinkronisasi dan menunjukkan bahwa jenis sinkronisasi ditentukan dalam anggota dwSlave dari struktur yang diidentifikasi oleh lpSet. MCISEQ mengembalikan MCIERR_UNSUPPORTED_FUNCTION. Konstanta berikut didefinisikan untuk jenis sinkronisasi:
-
MCI_SEQ_FILE
-
Mengatur pengurut untuk menerima data sinkronisasi yang terkandung dalam file MIDI.
-
MCI_SEQ_MIDI
-
Mengatur pengurut untuk menerima data sinkronisasi MIDI.
-
MCI_SEQ_NONE
-
Mengatur pengurut untuk mengabaikan data sinkronisasi dalam aliran MIDI.
-
MCI_SEQ_SMPTE
-
Mengatur pengurut untuk menerima data sinkronisasi SMPTE.
-
MCI_SEQ_SET_TEMPO
-
Mengubah tempo urutan MIDI menjadi yang ditentukan oleh anggota dwTempo dari struktur yang diarahkan oleh lpSet. Untuk urutan dengan jenis pembagian PPQN, tempo ditentukan dalam ketukan per menit; untuk urutan dengan jenis pembagian SMPTE, tempo ditentukan dalam bingkai per detik.
Untuk perangkat sequencer, parameter lpSet menunjuk ke struktur MCI_SEQ_SET_PARMS .
Bendera tambahan berikut digunakan dengan jenis perangkat vcr :
-
MCI_VCR_SET_ASSEMBLE_RECORD
-
Mengatur perangkat untuk merekam dalam mode rakit atau sisipkan (saat merakit nonaktif, sisipkan aktif, dan sebaliknya). Gunakan dengan salah satu bendera berikut:
-
MCI_SET_ON
-
Mengatur merakit rekaman, dan menonaktifkan sisipkan rekaman. Merekam semua trek video, audio, dan kode waktu.
-
MCI_SET_OFF
-
Mengatur rakit rekaman, dan mengaktifkan sisipkan rekaman. Saat merakit rekaman nonaktif, trek individual video, audio, dan kode waktu dapat dipilih untuk perekaman.
-
MCI_VCR_SET_CLOCK
-
Anggota dwClock struktur yang diidentifikasi oleh lpSet berisi waktu jam baru.
-
MCI_VCR_SET_COUNTER_FORMA
-
Anggota dwCounterFormat dari struktur yang diidentifikasi oleh lpSet berisi konstanta yang menentukan format waktu penghitung baru yang akan digunakan oleh penghitung status. Untuk daftar konstanta yang valid, lihat MCI_SET_TIME_FORMAT dalam daftar bendera tambahan untuk perintah ini.
-
MCI_VCR_SET_COUNTER_VALUE
-
Anggota dwCounterValue dari struktur yang diidentifikasi oleh lpSet berisi nilai penghitung baru.
-
MCI_VCR_SET_INDEX
-
Anggota dwIndex dari struktur yang diidentifikasi oleh lpSet berisi konstanta yang menunjukkan konten tampilan di layar dan harus salah satu dari berikut ini:
-
MCI_VCR_INDEX_COUNTER
-
Menampilkan penghitung.
-
MCI_VCR_INDEX_DATE
-
Menampilkan tanggal.
-
MCI_VCR_INDEX_TIME
-
Menampilkan waktu.
-
MCI_VCR_INDEX_TIMECODE
-
Menampilkan kode waktu.
Untuk informasi selengkapnya, lihat perintah MCI_INDEX .
-
MCI_VCR_SET_PAUSE_TIMEOUT
-
Anggota dwPauseTimeout dari struktur yang diidentifikasi oleh lpSet berisi durasi maksimum, dalam milidetik, dari perintah jeda.
-
MCI_VCR_SET_POSTROLL_DURATION
-
Anggota dwPostrollDuration dari struktur yang diidentifikasi oleh lpSet berisi panjang pita video, dalam format waktu saat ini, yang diperlukan untuk mengerem transportasi VCR saat perintah berhenti atau jeda dikeluarkan.
-
MCI_VCR_SET_POWER
-
Mengatur daya menyala atau mati. Harus digunakan dengan salah satu bendera berikut:
-
MCI_SET_OFF
-
Mematikan daya.
-
MCI_SET_ON
-
Nyalakan daya.
-
MCI_VCR_SET_PREROLL_DURATION
-
Anggota dwPrerollDuration dari struktur yang diidentifikasi oleh lpSet berisi panjang videotape, dalam format waktu saat ini, yang diperlukan untuk menstabilkan output VCR.
-
MCI_VCR_SET_RECORD_FORMAT
-
Anggota dwRecordFormat dari struktur yang diidentifikasi oleh lpSet berisi konstanta yang menjelaskan kecepatan rekaman, yang harus menjadi salah satu dari berikut ini:
-
MCI_VCR_FORMAT_EP
-
Merekam dengan kecepatan lambat.
-
MCI_VCR_FORMAT_LP
-
Merekam dengan kecepatan sedang lambat.
-
MCI_VCR_FORMAT_SP
-
Merekam pada kecepatan standar.
-
MCI_VCR_SET_SPEED
-
Anggota struktur dwSpeed yang diidentifikasi oleh lpSet berisi pengaturan kecepatan baru, di mana 1000 adalah kecepatan normal, 2000 adalah kecepatan ganda, dan 500 adalah setengah kecepatan, dan sebagainya.
-
MCI_VCR_SET_TAPE_LENGTH
-
Anggota struktur dwTapeLength yang diidentifikasi oleh lpSet berisi panjang pita baru, asalkan panjang pita tidak terdeteksi.
-
MCI_VCR_SET_TIME_MODE
-
Anggota dwTimeMode dari struktur yang diidentifikasi oleh lpSet berisi konstanta yang menunjukkan mode waktu posisi baru. Konstanta berikut ini valid:
-
MCI_VCR_TIME_COUNTER
-
Memaksa perangkat untuk menggunakan penghitung secara eksklusif.
-
MCI_VCR_TIME_DETECT
-
Setiap kali rekaman video baru dimasukkan ke dalam perangkat, atau mode berubah dari belum siap, perangkat harus mencoba menentukan apakah ada kode waktu yang tersedia pada rekaman video. Jika kode waktu tersedia, gunakan kode waktu di semua perintah berikutnya yang menentukan posisi. Jika tidak, gunakan penghitung.
-
MCI_VCR_TIME_TIMECODE
-
Memaksa perangkat untuk menggunakan kode waktu secara eksklusif.
-
MCI_VCR_SET_TRACKING
-
Sesuaikan kecepatan transportasi pita VCR dengan penyesuaian halus, dan harus digunakan dengan salah satu bendera berikut:
-
MCI_VCR_PLUS
-
Meningkatkan kecepatan transportasi pita.
-
MCI_VCR_MINUS
-
Mengurangi kecepatan transportasi pita.
-
MCI_VCR_RESET
-
Mengembalikan penyesuaian pelacakan ke nol.
Untuk perangkat VCR, parameter lpSet menunjuk ke struktur MCI_VCR_SET_PARMS .
Bendera tambahan berikut digunakan dengan jenis perangkat videodisc :
-
MCI_VD_FORMAT_TRACK
-
Mengubah format waktu menjadi trek. MCI menggunakan nomor trek berkelanjutan.
Bendera tambahan berikut digunakan dengan jenis perangkat waveaudio :
-
MCI_WAVE_INPUT
-
Mengatur input yang digunakan untuk merekam ke anggota wInput struktur yang diidentifikasi oleh lpSet.
-
MCI_WAVE_OUTPUT
-
Mengatur output yang digunakan untuk memutar ke anggota wOutput struktur yang diidentifikasi oleh lpSet.
-
MCI_WAVE_SET_ANYINPUT
-
Input gelombang apa pun yang kompatibel dengan format saat ini dapat digunakan untuk perekaman.
-
MCI_WAVE_SET_ANYOUTPUT
-
Output gelombang apa pun yang kompatibel dengan format saat ini dapat digunakan untuk memutar.
-
MCI_WAVE_SET_AVGBYTESPERSEC
-
Mengatur byte per detik yang digunakan untuk memutar, merekam, dan menyimpan ke anggota struktur nAvgBytesPerSec yang diidentifikasi oleh lpSet.
-
MCI_WAVE_SET_BITSPERSAMPLE
-
Mengatur bit per sampel yang digunakan untuk memutar, merekam, dan menyimpan ke anggota nBitsPerSample dari format data PCM yang diidentifikasi oleh lpSet.
-
MCI_WAVE_SET_BLOCKALIGN
-
Mengatur perataan blok yang digunakan untuk memutar, merekam, dan menyimpan ke anggota nBlockAlign struktur yang diidentifikasi oleh lpSet.
-
MCI_WAVE_SET_CHANNELS
-
Jumlah saluran ditunjukkan pada anggota nChannels dari struktur yang diidentifikasi oleh lpSet.
-
MCI_WAVE_SET_FORMATTAG
-
Mengatur jenis format yang digunakan untuk memutar, merekam, dan menyimpan ke anggota wFormatTag dari struktur yang diidentifikasi oleh lpSet. Menentukan WAVE_FORMAT_PCM mengubah format ke PCM.
-
MCI_WAVE_SET_SAMPLESPERSEC
-
Mengatur sampel per detik yang digunakan untuk memutar, merekam, dan menyimpan ke anggota struktur nSamplesPerSec yang diidentifikasi oleh lpSet.
Untuk perangkat waveform-audio, parameter lpSet menunjuk ke struktur MCI_WAVE_SET_PARMS .
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 bendera berikut mengidentifikasi properti ini:
- MCI_WAVE_SET_AVGBYTESPERSEC
- MCI_WAVE_SET_BITSPERSAMPLE
- MCI_WAVE_SET_BLOCKALIGN
- MCI_WAVE_SET_CHANNELS
- MCI_WAVE_SET_FORMATTAG
- MCI_WAVE_SET_SAMPLESPERSEC
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk