Klasifikasi Perintah MCI

[Fitur yang terkait dengan halaman ini, MCI, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih MCI, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

MCI mendefinisikan empat klasifikasi perintah: sistem, diperlukan, dasar, dan diperluas. Daftar berikut ini menjelaskan klasifikasi perintah ini:

• Perintah sistem ditangani oleh MCI secara langsung, bukan oleh driver.
• Perintah yang diperlukan ditangani oleh driver. Semua driver MCI harus mendukung perintah dan bendera yang diperlukan.
• Perintah dasar (atau perintah opsional) digunakan oleh beberapa perangkat. Jika perangkat mendukung perintah dasar, perangkat harus mendukung serangkaian bendera yang ditentukan untuk perintah tersebut.
• Perintah yang diperluas khusus untuk jenis perangkat atau driver. Perintah yang diperluas mencakup perintah, seperti perintah menempatkan (MCI_PUT) dan di mana perintah (MCI_WHERE) untuk digitalvideo dan overlay jenis perangkat, dan ekstensi ke perintah yang ada (seperti bendera "stretch" dari perintah status (MCI_STATUS) untuk jenis perangkat overlay).

Meskipun perintah sistem dan yang diperlukan adalah perintah minimum yang ditetapkan untuk driver MCI apa pun, perintah dasar dan diperluas tidak didukung oleh semua driver. Aplikasi Anda selalu dapat menggunakan sistem dan perintah yang diperlukan dan benderanya, tetapi jika perlu menggunakan perintah atau bendera dasar atau diperluas, aplikasi harus terlebih dahulu mengkueri driver dengan menggunakan kemampuan (MCI_GETDEVCAPS) perintah. Bagian berikut ini meringkas perintah tertentu di setiap kategori.

Perintah Sistem

MCI memproses perintah sistem berikut secara langsung, daripada meneruskannya ke perangkat MCI.

Tali	Pesan	Deskripsi
jeda	MCI_BREAK	Mengatur kunci henti untuk perangkat MCI.
sysinfo	MCI_SYSINFO	Mengembalikan informasi tentang perangkat MCI.

 

Perintah yang Diperlukan

Semua perangkat MCI mendukung perintah yang diperlukan berikut.

Tali	Pesan	Deskripsi
kemampuan	MCI_GETDEVCAPS	Mendapatkan kemampuan perangkat.
menutup	MCI_CLOSE	Menutup perangkat.
info	MCI_INFO	Mendapatkan informasi tekstual dari perangkat.
terbuka	MCI_OPEN	Menginisialisasi perangkat.
status	MCI_STATUS	Mendapatkan informasi status dari perangkat. Beberapa bendera perintah ini tidak diperlukan, jadi ini juga merupakan perintah dasar.

 

Perangkat juga harus mendukung sekumpulan bendera perintah standar untuk perintah yang diperlukan.

Perintah Dasar

Daftar berikut ini meringkas perintah dasar. Penggunaan perintah ini oleh perangkat MCI bersifat opsional.

Tali	Pesan	Deskripsi
memuat	MCI_LOAD	Memuat data dari file.
menjeda	MCI_PAUSE	Berhenti bermain. Pemutaran atau perekaman dapat dilanjutkan pada posisi saat ini.
bermain	MCI_PLAY	Mulai mengirimkan data output.
rekaman	MCI_RECORD	Mulai merekam data input.
melanjutkan	MCI_RESUME	Melanjutkan pemutaran atau perekaman pada perangkat yang dijeda.
menyimpan	MCI_SAVE	Menyimpan data ke file disk.
mencari	MCI_SEEK	Mencari maju atau mundur.
set	MCI_SET	Mengatur status operasi perangkat.
status	STATUSMCI	Mendapatkan informasi status tentang perangkat. Ini juga merupakan perintah yang diperlukan; karena beberapa benderanya tidak diperlukan, bendera juga tercantum di sini. (Item opsional mendukung perangkat yang menggunakan media linier dengan posisi yang dapat diidentifikasi.)
menghentikan	MCI_STOP	Berhenti bermain.

 

Jika driver mendukung perintah dasar, driver juga harus mendukung sekumpulan bendera standar untuk perintah .

Perintah yang Diperluas

Beberapa perangkat MCI memiliki perintah tambahan, atau menambahkan bendera ke perintah yang ada. Meskipun beberapa perintah yang diperluas hanya berlaku untuk driver perangkat tertentu, sebagian besar berlaku untuk semua driver dari jenis perangkat tertentu. Misalnya, perintah yang ditetapkan untuk urutan jenis perangkat memperluas perintah set (MCI_SET) untuk menambahkan format waktu yang diperlukan oleh pengurut MIDI.

Anda tidak boleh berasumsi bahwa perangkat mendukung perintah atau bendera yang diperluas. Anda dapat menggunakan perintahkemampuan(MCI_GETDEVCAPS) untuk menentukan apakah fitur tertentu didukung, dan aplikasi Anda harus siap untuk menangani nilai pengembalian "perintah yang tidak didukung" atau "fungsi yang tidak didukung".

Perintah yang diperluas berikut ini tersedia dengan jenis perangkat yang tercantum.

Tali	Pesan	Jenis perangkat	Deskripsi
mengonfigurasi	MCI_CONFIGURE	digitalvideo	Menampilkan kotak dialog konfigurasi.
isian	MCI_CUE	digitalvideo, waveaudio	Bersiap untuk memutar atau merekam.
menghapus	MCI_DELETE	waveaudio	Menghapus segmen data dari file media.
escape	MCI_ESCAPE	videodisc	Mengirim informasi kustom ke perangkat.
membekukan	MCI_FREEZE	Overlay	Menonaktifkan akuisisi video ke buffer bingkai.
menempatkan	MCI PUT	digitalvideo, overlay	Menentukan jendela sumber, tujuan, dan bingkai.
menyadari	MCI_REALIZE	digitalvideo	Memberi tahu perangkat untuk memilih dan mewujudkan paletnya ke dalam konteks perangkat dari jendela yang ditampilkan.
setaudio	SETAUDIOMCI_	digitalvideo	Mengatur parameter audio untuk video.
setvideo	SETVIDEOMCI_	digitalvideo	Mengatur parameter video.
sinyal	MCI_SIGNAL	digitalvideo	Mengidentifikasi posisi tertentu dengan sinyal.
spin	MCI_SPIN	videodisc	Memulai cakram yang berputar atau menghentikan cakram berputar.
langkah	MCI_STEP	digitalvideo, videodisc	Langkah-langkah putar satu atau beberapa bingkai ke depan atau mundur.
mencairkan	MCI_UNFREEZE	Overlay	Memungkinkan buffer bingkai untuk memperoleh data video.
pembaruan	MCI_UPDATE	digitalvideo	Mengecat ulang bingkai saat ini ke dalam konteks perangkat.
tempat	MCI WHERE	digitalvideo, overlay	Mendapatkan persegi panjang yang menentukan area sumber, tujuan, atau bingkai.
jendela	MCI_WINDOW	digitalvideo, overlay	Mengontrol jendela tampilan.