Pesan Perintah

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

Antarmuka pesan perintah dirancang untuk digunakan oleh aplikasi yang memerlukan antarmuka bahasa C untuk mengontrol perangkat multimedia. Ini menggunakan paradigma yang melewati pesan untuk berkomunikasi dengan perangkat MCI. Anda dapat mengirim perintah dengan menggunakan fungsi mciSendCommand .

Fungsi mciSendCommand mengembalikan nol jika berhasil. Jika fungsi gagal, kata berurutan rendah dari nilai yang dikembalikan berisi kode kesalahan. Anda dapat meneruskan kode kesalahan ini ke fungsi mciGetErrorString untuk mendapatkan deskripsi teks kesalahan.

Sintaks Pesan Perintah

Pesan perintah MCI terdiri dari elemen-elemen berikut:

  • Nilai pesan konstanta
  • Struktur yang berisi parameter untuk perintah
  • Sekumpulan bendera yang menentukan opsi untuk perintah dan memvalidasi bidang di blok parameter

Contoh berikut menggunakan fungsi mciSendCommand untuk mengirim perintah MCI_ PLAY ke perangkat yang diidentifikasi oleh pengidentifikasi perangkat.

mciSendCommand(wDeviceID,            // device identifier 
    MCI_PLAY,                        // command message 
    0,                               // flags 
    (DWORD)(LPVOID) &mciPlayParms);  // parameter block

Pengidentifikasi perangkat yang diberikan dalam parameter pertama diambil ketika perangkat dibuka menggunakan perintah MCI_ OPEN . Parameter terakhir adalah alamat struktur PARMS MCI_ PLAY_ , yang mungkin berisi informasi tentang tempat memulai dan mengakhiri pemutaran. Banyak pesan perintah MCI menggunakan struktur untuk berisi parameter semacam ini. Anggota pertama dari masing-masing struktur ini mengidentifikasi jendela yang menerima pesan MM_ MCINOTIFY ketika operasi selesai.