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 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. |