Klasifikasi Perintah MCI

  • Artikel

[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 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 put (MCI_PUT) dan di mana (MCI_WHERE) untuk jenis perangkat digitalvideo dan overlay , 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 diperpanjang 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 perintah kemampuan (MCI_GETDEVCAPS). Bagian berikut ini meringkas perintah tertentu di setiap kategori.

Perintah Sistem

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

String Pesan Deskripsi
Istirahat MCI_BREAK Mengatur kunci jeda untuk perangkat MCI.
sysinfo MCI_SYSINFO Mengembalikan informasi tentang perangkat MCI.

 

Perintah yang Diperlukan

Semua perangkat MCI mendukung perintah yang diperlukan berikut.

String Pesan Deskripsi
Kemampuan MCI_GETDEVCAPS Mendapatkan kemampuan perangkat.
Dekat 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, sehingga 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.

String Pesan Deskripsi
Beban MCI_LOAD Memuat data dari file.
Jeda MCI_PAUSE Berhenti bermain. Pemutaran atau perekaman dapat dilanjutkan pada posisi saat ini.
Bermain MCI_PLAY Mulai mengirimkan data output.
Catatan 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 MCI STATUS 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.)
Stop 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, set perintah untuk jenis perangkat pengurut 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 perintah kemampuan (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.

String Pesan Jenis perangkat Deskripsi
Mengkonfigurasi MCI_CONFIGURE digitalvideo Menampilkan kotak dialog konfigurasi.
isyarat MCI_CUE digitalvideo, waveaudio Bersiap untuk bermain 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 MCI_ SETAUDIO digitalvideo Mengatur parameter audio untuk video.
setvideo MCI_ SETVIDEO digitalvideo Mengatur parameter video.
Sinyal MCI_SIGNAL digitalvideo Mengidentifikasi posisi tertentu dengan sinyal.
Spin MCI_SPIN videodisc Memulai pemintalan cakram atau menghentikan pemutaran cakram.
Langkah MCI_STEP digitalvideo, videodisc Langkah-langkah putar satu atau beberapa bingkai ke depan atau terbalik.
batalkan pembekuan MCI_UNFREEZE Overlay Memungkinkan buffer bingkai untuk memperoleh data video.
Update MCI_UPDATE digitalvideo Mengecat ulang bingkai saat ini ke dalam konteks perangkat.
Mana MCI DI MANA digitalvideo, overlay Mendapatkan persegi panjang yang menentukan area sumber, tujuan, atau bingkai.
Jendela MCI_WINDOW digitalvideo, overlay Mengontrol jendela tampilan.