perintah MCI_RESERVE

Perintah MCI_RESERVE mengalokasikan ruang disk yang bersebelahan untuk ruang kerja instans driver perangkat untuk digunakan dengan perekaman berikutnya. Perangkat digital-video mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESERVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESERVE_PARMS) lpReserve
);

Parameter

wDeviceID

Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.

dwFlags

MCI_NOTIFY, MCI_WAIT, atau MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

lpReserve

Arahkan ke struktur MCI_DGV_RESERVE_PARMS .

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Jika ruang kerja berisi data yang tidak disimpan, data ini akan hilang. Jika ruang disk tidak dicadangkan sebelum perekaman, perintah MCI_RECORD melakukan cadangan tersirat dengan parameter default khusus perangkat. Pada beberapa implementasi, cadangan tidak diperlukan dan mungkin diabaikan oleh driver perangkat. Secara eksplisit mempertahankan ruang memberi Anda kontrol yang lebih baik ketika penundaan untuk alokasi disk terjadi, berapa banyak ruang yang dialokasikan, dan di mana ruang disk dialokasikan. Jumlah dan lokasi ruang disk yang sudah dicadangkan untuk instans perangkat ini dapat diubah dengan mengeluarkan MCI_RESERVE lagi. Ruang disk apa pun yang dialokasikan dan masih tidak digunakan tidak dialokasikan sampai data yang direkam disimpan atau sampai instans driver perangkat ditutup.

Jika video dinonaktifkan dengan bendera MCI_OFF perintah MCI_SETVIDEO , spasi yang dicadangkan tidak menyertakan video apa pun. Jika audio dimatikan dengan bendera MCI_OFF perintah MCI_SETAUDIO , ruang yang dicadangkan tidak menyertakan audio apa pun. Jika audio dan video dimatikan atau jika ukuran yang diminta adalah nol, tidak ada ruang yang dicadangkan dan ruang cadangan yang ada tidak dialokasikan.

Bendera tambahan berikut berlaku untuk perangkat video digital:

MCI_DGV_RESERVE_IN

Anggota lpstrPath dari struktur yang diidentifikasi oleh lpReserve berisi alamat buffer yang berisi lokasi file sementara. Buffer hanya berisi drive dan jalur direktori file yang digunakan untuk menyimpan data yang direkam; nama file ditentukan oleh driver perangkat. File sementara ini dihapus ketika instans perangkat ditutup kecuali disimpan secara eksplisit. Jika bendera ini dihilangkan, driver perangkat menentukan di mana ruang disk dialokasikan.

MCI_DGV_RESERVE_SIZE

Anggota dwSize dari struktur yang diidentifikasi oleh lpReserve menentukan perkiraan jumlah ruang disk yang akan dicadangkan di ruang kerja untuk perekaman. Nilai ditentukan dalam format waktu saat ini. Jumlah ruang disk diperkirakan dari waktu yang diminta dan dari mana format file dan algoritma video dan audio serta nilai kualitas berlaku. Jika bendera ini dihilangkan, driver perangkat mungkin menggunakan nilai default yang ditentukannya.

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