perintah MCI_FREEZE

Perintah MCI_FREEZE membekukan gerakan pada layar. Perangkat digital-video, video-overlay, dan VCR mengenali perintah ini.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

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.
lpFreeze: Penunjuk ke struktur MCI_GENERIC_PARMS . (Perangkat dengan parameter tambahan mungkin mengganti struktur ini dengan struktur khusus perangkat.)

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Bendera tambahan berikut digunakan oleh jenis perangkat digitalvideo :

MCI_DGV_FREEZE_AT: Anggota rc struktur yang diidentifikasi oleh lpFreeze berisi persegi panjang yang valid. Persegi panjang menentukan wilayah dalam buffer bingkai yang akan mengaktifkan bit masker kunci untuk setiap piksel. Piksel yang ditentukan tidak akan diperbarui hingga bit mask kuncinya dimatikan. Jika bendera ini tidak ditentukan, persegi panjang default ke seluruh buffer bingkai. Bendera ini hanya didukung jika perintah MCI_GETDEVCAPS mengembalikan TRUE untuk bendera MCI_DGV_GETDEVCAPS_CAN_LOCK.
MCI_DGV_FREEZE_OUTSIDE: Area di luar wilayah yang ditentukan untuk bendera MCI_DGV_FREEZE_AT dibekukan.

Untuk perangkat video digital, parameter lpFreeze menunjuk ke struktur MCI_DGV_FREEZE_PARMS .

Bendera tambahan berikut digunakan oleh jenis perangkat vcr :

MCI_VCR_FREEZE_FIELD: Bekukan hanya satu anggota bingkai saat ini.
MCI_VCR_FREEZE_FRAME: Bekukan kedua bidang bingkai saat ini.
MCI_VCR_FREEZE_INPUT: Bekukan bingkai saat ini pada layar (digunakan untuk perekaman).
MCI_VCR_FREEZE_OUTPUT: Bekukan bingkai saat ini dari VCR (digunakan dengan pengambilan bingkai).

Untuk perangkat VCR, parameter lpFreeze menunjuk ke struktur MCI_GENERIC_PARMS .

Bendera tambahan berikut digunakan oleh jenis perangkat overlay :

MCI_OVLY_RECT: Anggota rc struktur yang diidentifikasi oleh lpFreeze berisi persegi panjang yang valid. Jika bendera ini tidak ditentukan, driver perangkat akan membekukan seluruh bingkai.

Untuk perangkat video-overlay, parameter lpFreeze menunjuk ke struktur MCI_OVLY_RECT_PARMS .

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)