Makro dan Pesan Fungsi MCI

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, maksimal 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 bisa 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 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.