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.