perintah MCI_OPEN

Perintah MCI_OPEN menginisialisasi perangkat atau file. Semua perangkat mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_OPEN, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_OPEN_PARMS) lpOpen
);

Parameter

wDeviceID

Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.

dwFlags

MCI_NOTIFY atau MCI_WAIT. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

lpBuka

Arahkan ke struktur MCI_OPEN_PARMS . (Perangkat dengan set perintah yang diperluas mungkin mengganti struktur ini dengan struktur khusus perangkat.)

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Bendera MCI_OPEN_TYPE harus digunakan setiap kali perangkat ditentukan dalam fungsi mciSendCommand . Jika Anda membuka perangkat dengan menentukan konstanta jenis perangkat, Anda harus menentukan bendera MCI_OPEN_TYPE_ID selain MCI_OPEN_TYPE. Untuk daftar konstanta jenis perangkat, lihat Jenis Perangkat MCI.

Jika bendera MCI_OPEN_SHAREABLE tidak ditentukan saat perangkat atau file awalnya dibuka, semua perintah MCI_OPEN berikutnya ke perangkat atau file akan gagal. Jika perangkat atau file sudah terbuka dan bendera ini tidak ditentukan, panggilan akan gagal meskipun perintah buka pertama yang ditentukan MCI_OPEN_SHAREABLE. File dibuka untuk MCISEQ. DRV dan MCIWAVE. Perangkat DRV tidak dapat dibagikan.

Kasus diabaikan dalam nama perangkat, tetapi tidak boleh ada kosong di depan atau setelahnya.

Untuk menggunakan pilihan jenis otomatis (melalui entri dalam registri), tetapkan nama file dan ekstensi file ke anggota lpstrElementName struktur yang diidentifikasi oleh lpOpen, atur anggota lpstrDeviceType ke NULL, dan atur bendera MCI_OPEN_ELEMENT.

Bendera tambahan berikut berlaku untuk semua perangkat yang mendukung MCI_OPEN:

MCI_OPEN_ALIAS

Alias disertakan dalam anggota lpstrAlias dari struktur yang diidentifikasi oleh lpOpen.

MCI_OPEN_SHAREABLE

Perangkat atau file harus dibuka sebagai dapat dibagikan.

MCI_OPEN_TYPE

Nama atau konstanta jenis perangkat disertakan dalam anggota lpstrDeviceType dari struktur yang diidentifikasi oleh lpOpen.

MCI_OPEN_TYPE_ID

Kata urutan rendah dari anggota lpstrDeviceType dari struktur yang diidentifikasi oleh lpOpen berisi pengidentifikasi jenis perangkat MCI standar dan kata urutan tinggi secara opsional berisi indeks ordinal untuk perangkat. Gunakan bendera ini dengan bendera MCI_OPEN_TYPE.

Bendera tambahan berikut berlaku untuk perangkat campuran:

MCI_OPEN_ELEMENT

Nama file disertakan dalam anggota lpstrElementName dari struktur yang diidentifikasi oleh lpOpen.

MCI_OPEN_ELEMENT_ID

Anggota lpstrElementName dari struktur yang diidentifikasi oleh lpOpen ditafsirkan sebagai nilai DWORD dan memiliki arti internal untuk perangkat. Gunakan bendera ini dengan bendera MCI_OPEN_ELEMENT.

Bendera tambahan berikut digunakan dengan jenis perangkat digitalvideo :

MCI_DGV_OPEN_NOSTATIC

Perangkat harus mengurangi jumlah warna statis (sistem) di palet. Ini meningkatkan jumlah warna yang tersedia untuk merender aliran video. Bendera ini hanya berlaku untuk perangkat yang berbagi palet dengan Windows.

MCI_DGV_OPEN_PARENT

Handel jendela induk ditentukan dalam anggota hWndParent dari struktur yang diidentifikasi oleh lpOpen.

MCI_DGV_OPEN_WS

Gaya jendela ditentukan dalam anggota dwStyle dari struktur yang diidentifikasi oleh lpOpen.

MCI_DGV_OPEN_16BIT

Menunjukkan preferensi untuk dukungan perangkat MCI 16-bit.

MCI_DGV_OPEN_32BIT

Menunjukkan preferensi untuk dukungan perangkat MCI 32-bit.

Untuk perangkat video digital, parameter lpOpen menunjuk ke struktur MCI_DGV_OPEN_PARMS .

Bendera tambahan berikut digunakan dengan jenis perangkat overlay :

MCI_OVLY_OPEN_PARENT

Handel jendela induk ditentukan dalam anggota hWndParent dari struktur yang diidentifikasi oleh lpOpen.

MCI_OVLY_OPEN_WS

Gaya jendela ditentukan dalam anggota dwStyle dari struktur yang diidentifikasi oleh lpOpen. Nilai dwStyle menentukan gaya jendela yang akan dibuat dan ditampilkan driver jika aplikasi tidak menyediakannya. Parameter gaya mengambil bilangan bulat yang menentukan gaya jendela. Konstanta ini sama dengan gaya jendela standar (seperti WS_CHILD, WS_OVERLAPPEDWINDOW, atau WS_POPUP).

Untuk perangkat video-overlay, parameter lpOpen menunjuk ke struktur MCI_OVLY_OPEN_PARMS .

Bendera tambahan berikut digunakan dengan jenis perangkat waveaudio :

MCI_WAVE_OPEN_BUFFER

Panjang buffer ditentukan dalam anggota dwBufferSeconds dari struktur yang diidentifikasi oleh lpOpen.

Untuk perangkat waveform-audio, parameter lpOpen menunjuk ke struktur MCI_WAVE_OPEN_PARMS . Driver MCIWAVE memerlukan perangkat waveform-audio asinkron.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Mmsystem.h (termasuk Windows.h)

Lihat juga

MCI

Perintah MCI