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	Mmsystem.h (termasuk Windows.h)

Lihat juga

MCI

Perintah MCI