perintah MCI_SAVE
Perintah MCI_SAVE menyimpan file saat ini. Perangkat yang mengubah file tidak boleh menghancurkan salinan asli hingga menerima pesan simpan. Perangkat video-overlay dan waveform-audio mengenali perintah ini. Meskipun perangkat video digital dan pengurut MIDI juga mengenali perintah ini, driver MCIAVI dan MCISEQ tidak mengimplementasikannya.
Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SAVE,
DWORD dwFlags,
(DWORD) (LPMCI_SAVE_PARMS ) lpSave
);
Parameter
-
wDeviceID
-
Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, atau, untuk perangkat digital-video dan VCR, MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.
-
lpSave
-
Arahkan ke struktur MCI_SAVE_PARMS . (Perangkat dengan parameter tambahan mungkin mengganti struktur ini dengan struktur khusus perangkat.)
Tampilkan Nilai
Mengembalikan nol jika berhasil atau kesalahan sebaliknya.
Keterangan
Perintah ini didukung oleh perangkat yang mengembalikan TRUE saat Anda memanggil perintah MCI_GETDEVCAPS dengan bendera MCI_GETDEVCAPS_CAN_SAVE.
Bendera tambahan berikut berlaku untuk semua perangkat yang mendukung MCI_SAVE:
-
MCI_SAVE_FILE
-
Anggota lpfilename dari struktur yang diidentifikasi oleh lpSave berisi alamat buffer yang berisi nama file tujuan.
Bendera tambahan berikut digunakan dengan jenis perangkat digitalvideo :
-
MCI_DGV_RECT
-
Anggota rc struktur yang diidentifikasi oleh lpSave berisi persegi panjang yang valid. Persegi panjang menentukan wilayah buffer bingkai yang akan disimpan ke file yang ditentukan. Pasangan koordinat pertama menentukan sudut kiri atas persegi; pasangan kedua menentukan lebar dan tinggi. Perangkat digital-video harus menggunakan perintah MCI_CAPTURE untuk mengambil konten buffer bingkai. (Perangkat video-overlay juga harus menggunakan MCI_CAPTURE.) Bendera ini untuk kompatibilitas dengan kumpulan perintah video-overlay MCI yang ada.
-
MCI_DGV_SAVE_ABORT
-
Menghentikan operasi penyimpanan yang sedang berlangsung. Ini harus menjadi satu-satunya bendera yang ada.
-
MCI_DGV_SAVE_KEEPRESERVE
-
Ruang disk yang tidak digunakan yang tersisa dari perintah MCI_RESERVE asli tidak dibatalkan alokasinya.
Untuk perangkat video digital, parameter lpSave menunjuk ke struktur MCI_DGV_SAVE_PARMS .
Bendera tambahan berikut digunakan dengan jenis perangkat overlay :
-
MCI_OVLY_RECT
-
Anggota rc struktur yang diidentifikasi oleh lpSave berisi persegi panjang tampilan yang valid yang menunjukkan area buffer video untuk disimpan.
Untuk perangkat video-overlay, parameter lpSave menunjuk ke struktur MCI_OVLY_SAVE_PARMS .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|