Baca dalam bahasa Inggris

Bagikan melalui


buka perintah

Perintah buka menginisialisasi perangkat. Semua perangkat MCI mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendString dengan parameter lpszCommand yang ditetapkan sebagai berikut.

_stprintf_s(
  lpszCommand, 
  TEXT("open %s %s %s"), 
  lpszDevice, 
  lpszOpenFlags, 
  lpszFlags
); 

Parameter

lpszDevice

Pengidentifikasi perangkat MCI atau driver perangkat. Ini bisa berupa nama perangkat (seperti yang diberikan dalam registri atau file SYSTEM.INI) atau nama file driver perangkat. Jika Anda menentukan nama file driver perangkat, Anda dapat secara opsional menyertakan . Ekstensi DRV, tetapi Anda tidak boleh menyertakan jalur ke file.

lpszOpenFlags

Bendera yang mengidentifikasi apa yang harus diinisialisasi. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah terbuka dan bendera yang digunakan oleh setiap jenis.

Nilai Makna Makna
cdaudio alias device_aliasdapat dibagikan ketik device_type
digitalvideo alias device_aliaselementnamenostatic parent hwndsharable gaya anak gaya gaya tumpang tindih gaya popup style_typetipe device_type
Overlay alias device_aliasanak gaya hwndsharable induk gaya gaya popup yang tumpang tindih gaya style_typetipe device_type
Sequencer alias device_alias dapat dibagikan ketik device_type
Vcr alias device_aliasdapat dibagikan ketik device_type
videodisk alias device_aliasdapat dibagikan ketik device_type
waveaudio buffer_size buffer alias device_alias jenis yang dapat dibagikan device_type

Tabel berikut mencantumkan bendera yang dapat ditentukan dalam parameter lpszOpenFlags dan maknanya.

Nilai Makna
alias device_alias Menentukan nama alternatif untuk perangkat yang diberikan. Jika ditentukan, itu harus digunakan sebagai device_id dalam perintah berikutnya.
nama elemen Menentukan nama elemen perangkat (file) yang dimuat saat perangkat terbuka.
buffer_size buffer Mengatur ukuran, dalam detik, dari buffer yang digunakan oleh perangkat waveform-audio. Ukuran default buffer diatur ketika perangkat waveform-audio diinstal atau dikonfigurasi. Biasanya ukuran buffer diatur ke 4 detik. Dengan perangkat MCIWAVE, ukuran minimum adalah 2 detik dan ukuran maksimumnya adalah 9 detik.
hwnd induk Menentukan handel jendela jendela induk.
Sharable Menginisialisasi perangkat atau file sebagai dapat dibagikan. Upaya berikutnya untuk membuka perangkat atau file gagal kecuali Anda menentukan "dapat dibagikan" dalam perintah terbuka asli dan berikutnya. MCI mengembalikan kesalahan perangkat yang tidak valid jika perangkat sudah terbuka dan tidak dapat dibagikan.
Sequencer MCISEQ dan perangkat MCIWAVE tidak mendukung file bersama.
gaya anak Membuka jendela dengan gaya jendela anak.
gaya tumpang tindih Membuka jendela dengan gaya jendela yang tumpang tindih.
popup gaya Membuka jendela dengan gaya jendela pop-up.
gaya style_type Menunjukkan gaya jendela.
ketik device_type Menentukan tipe perangkat file.

lpszFlags

Bisa "tunggu", "beri tahu", atau keduanya. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

MCI mencadangkan "cdaudio" untuk jenis perangkat audio CD, "videodisc" untuk jenis perangkat videodisc, "sequencer" untuk jenis perangkat pengurut MIDI, "AVIVideo" untuk jenis perangkat video digital, dan "waveaudio" untuk jenis perangkat waveform-audio.

Sebagai alternatif untuk bendera "jenis", MCI dapat memilih perangkat berdasarkan ekstensi yang digunakan oleh file, seperti yang direkam di registri atau bagian [ekstensi mci] dari file SYSTEM.INI.

MCI dapat membuka file AVI dengan menggunakan penunjuk antarmuka file atau penunjuk antarmuka aliran. Untuk membuka file dengan menggunakan salah satu jenis penunjuk antarmuka, tentukan tanda (@) diikuti dengan penunjuk antarmuka sebagai pengganti nama file atau perangkat untuk parameter lpszDevice . Untuk informasi selengkapnya tentang antarmuka file dan aliran, lihat " Fungsi dan Makro AVIFile."

Perintah berikut membuka perangkat "mysound".

open new type waveaudio alias mysound buffer 6

Dengan nama perangkat "baru", driver bentuk gelombang menyiapkan sumber daya bentuk gelombang baru. Perintah menetapkan alias perangkat "mysound" dan menentukan buffer 6 detik.

Anda dapat menghilangkan bendera "jenis" jika Anda menggabungkan nama perangkat dengan nama file. MCI mengenali kombinasi ini saat Anda menggunakan sintaks berikut:

device_name ! element_name

Tanda seru memisahkan nama perangkat dari nama file. Tanda seru tidak boleh dibatasi oleh spasi kosong.

Contoh berikut membuka RIGHT. File WAV menggunakan perangkat "waveaudio".

open waveaudio!right.wav

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
Corecrt_io.h

Lihat juga

MCI

String Perintah MCI