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 |
|