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	Mmsystem.h (termasuk Windows.h)

Lihat juga

MCI

Perintah MCI