Makro dan Pesan Fungsi 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.]
Sebagian besar aplikasi MCI menggunakan fungsi mciSendString dan mciSendCommand puluhan kali. MCI menyediakan beberapa fungsi berguna lainnya yang akan lebih jarang digunakan aplikasi Anda.
Pengidentifikasi perangkat yang diperlukan oleh sebagian besar perintah MCI biasanya diambil dalam panggilan ke perintah buka (MCI_OPEN). Jika Anda memerlukan pengidentifikasi perangkat tetapi tidak ingin membuka perangkat — misalnya, jika Anda ingin mengkueri kemampuan perangkat sebelum mengambil tindakan lain — Anda dapat memanggil fungsi mciGetDeviceID .
Fungsi mciGetCreatorTask memungkinkan aplikasi Anda menggunakan pengidentifikasi perangkat untuk mengambil handel ke tugas yang membuat pengidentifikasi tersebut.
Anda dapat menggunakan fungsi mciGetYieldProc dan mciSetYieldProc untuk menetapkan dan mengambil alamat fungsi panggilan balik yang terkait dengan bendera "tunggu" (MCI_WAIT).
Fungsi mciGetErrorString mengambil string yang menjelaskan nilai kesalahan MCI. Setiap string yang dikembalikan MCI, baik data atau deskripsi kesalahan, adalah maksimum 128 karakter. Bidang kotak dialog yang lebih kecil dari 128 karakter akan memotong string yang lebih panjang yang dikembalikan oleh MCI. Untuk informasi selengkapnya tentang string ini, lihat Nilai Pengembalian MCIERR.
Makro MCI adalah alat yang dapat Anda gunakan untuk membuat dan membongkar nilai yang menentukan format waktu. Format waktu ini digunakan dalam banyak perintah MCI. Format yang ditindaklanjuti oleh makro adalah jam/menit/detik (HMS), menit/detik/bingkai (MSF), dan trek/menit/detik/bingkai (TMSF). Tabel berikut ini mencantumkan makro dan deskripsinya.
| Makro | Deskripsi |
|---|---|
| MCI_HMS_HOUR | Mengambil komponen jam dari nilai HMS. |
| MCI_HMS_MINUTE | Mengambil komponen menit dari nilai HMS. |
| MCI_HMS_SECOND | Mengambil komponen detik dari nilai HMS. |
| MCI_MAKE_HMS | Membuat nilai HMS. |
| MCI_MAKE_MSF | Membuat nilai MSF. |
| MCI_MAKE_TMSF | Membuat nilai TMSF. |
| MCI_MSF_FRAME | Mengambil komponen bingkai dari nilai MSF. |
| MCI_MSF_MINUTE | Mengambil komponen menit dari nilai MSF. |
| MCI_MSF_SECOND | Mengambil komponen detik dari nilai MSF. |
| MCI_TMSF_FRAME | Mengambil komponen bingkai dari nilai TMSF. |
| MCI_TMSF_MINUTE | Mengambil komponen menit dari nilai TMSF. |
| MCI_TMSF_SECOND | Mengambil komponen detik dari nilai TMSF. |
| MCI_TMSF_TRACK | Mengambil komponen trek dari nilai TMSF. |
MCI juga menyediakan dua pesan: MM_MCINOTIFY dan MM_MCISIGNAL. Pesan MM_MCINOTIFY memberi tahu aplikasi hasil perintah MCI setiap kali perintah tersebut menentukan bendera "beri tahu" (MCI_NOTIFY). Pesan MM_MCISIGNAL khusus untuk perangkat video digital; ini memberi tahu aplikasi ketika posisi yang ditentukan tercapai.