perintah reserve

Perintah cadangan mengalokasikan ruang disk yang bersebelahan untuk ruang kerja instans perangkat. Perangkat digital-video mengenali perintah ini.

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

_stprintf_s(
  lpszCommand, 
  TEXT("reserve %s %s %s"), 
  lpszDeviceID, 
  lpszReserve, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszReserve

Satu atau beberapa bendera berikut.

Nilai	Makna
di jalur	Menentukan jalur drive dan direktori (tetapi bukan nama) dari file sementara yang digunakan untuk menyimpan data yang direkam. Nama file ini ditentukan oleh perangkat. File sementara dihapus ketika perangkat ditutup. Jika bendera ini dihilangkan, perangkat menentukan lokasi ruang disk.
durasi ukuran	Menentukan perkiraan jumlah ruang disk yang akan dicadangkan di ruang kerja. Nilai durasi ditentukan dalam format waktu saat ini. Perangkat mendasarkan perkiraan ruang disk yang diperlukan pada parameter berikut: waktu yang diminta, format file, algoritma kompresi video dan audio, dan nilai kualitas kompresi yang berlaku. Jika setvideo "record" "off", maka spasi hanya dicadangkan untuk audio. Jika setaudio "record" "off", maka spasi hanya dicadangkan untuk video. Jika keduanya "nonaktif", atau jika durasinya nol, maka tidak ada ruang yang dicadangkan dan ruang cadangan yang ada tidak dialokasikan. Jika bendera ini dihilangkan, perangkat akan menggunakan default yang ditentukan perangkat.

lpszFlags

Dapat berupa "tunggu", "beri tahu", "uji", atau kombinasi ini. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Jika diperlukan, perintah rekam atau simpan berikutnya menggunakan ruang yang dicadangkan oleh perintah ini. Jika ruang kerja berisi data yang tidak disimpan, data akan hilang. Beberapa perangkat tidak memerlukan cadangan dan mengabaikannya. Jika ruang disk tidak dicadangkan sebelum perekaman, perintah rekaman melakukan cadangan tersirat dengan bendera default khusus perangkat. Gunakan perintah cadangan eksplisit jika Anda ingin mengontrol dengan lebih baik kapan penundaan untuk alokasi disk terjadi, kontrol berapa banyak ruang yang dialokasikan, dan kontrol tempat ruang disk dialokasikan. Aplikasi Anda dapat mengubah jumlah dan lokasi ruang disk yang dipesan sebelumnya dengan perintah cadangan berikutnya. Ruang disk apa pun yang dialokasikan dan masih tidak digunakan tidak dialokasikan sampai data yang direkam disimpan, atau sampai instans perangkat ditutup.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]

Lihat juga

MCI

String Perintah MCI

record

Menyimpan

setaudio

setvideo