perintah simpan

Perintah simpan menyimpan file MCI. 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 mendukungnya.

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

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
); 

Parameter

lpszDeviceID

Pengidentifikasi perangkat MCI. Pengidentifikasi atau alias ini ditetapkan saat perangkat dibuka.

lpszFilename

Bendera yang menentukan nama file yang disimpan dan, secara opsional, bendera tambahan yang memodifikasi operasi penyimpanan. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah simpan dan bendera yang digunakan oleh setiap jenis.

Nilai	Makna	Makna
digitalvideo	batalkan pada persegi panjang	keepreserve nama file
Overlay	pada persegi panjang	nama file
Sequencer	nama file
waveaudio	nama file

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

Nilai	Makna
abort	Menghentikan operasi penyimpanan yang sedang berlangsung. Jika digunakan, ini harus menjadi satu-satunya item yang ada.
pada persegi panjang	Menentukan persegi relatif terhadap asal buffer bingkai. Persegi panjang ditentukan sebagai X1 Y1 X2 Y2. Koordinat X1 Y1 menentukan sudut kiri atas dan koordinat X2 Y2 menentukan lebar dan tinggi. Untuk perangkat video digital, perintah pengambilan digunakan untuk mengambil konten buffer bingkai.
nama file	Menentukan nama file yang akan ditetapkan ke file data. Jika jalur tidak ditentukan, file akan ditempatkan pada disk dan di direktori yang sebelumnya ditentukan pada perintah cadangan eksplisit atau implisit. Jika cadangan belum diterbitkan, drive dan direktori default adalah yang terkait dengan tugas aplikasi. Jika jalur ditentukan, perangkat mungkin mengharuskannya berada di drive disk yang ditentukan oleh cadangan eksplisit atau implisit. Bendera ini diperlukan.
keepreserve	Menentukan bahwa ruang disk yang tidak digunakan yang tersisa dari perintah cadangan asli tidak dibatalkan alokasinya.

lpszFlags

Bisa "tunggu", "beri tahu", atau keduanya. Untuk perangkat digital-video dan VCR, "pengujian" juga dapat ditentukan. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Variabel nama file diperlukan jika perangkat dibuka menggunakan pengidentifikasi perangkat "baru".

Contoh

Perintah berikut menyimpan seluruh buffer video ke file bernama VCAPFILE. TGA.

save vboard c:\vcap\vcapfile.tga

Persyaratan

Lihat juga

MCI

String Perintah MCI

Menangkap

Reserve