perintah bekukan

Artikel
06/13/2023

Perintah bekukan membekukan input video atau output video pada VCR atau menonaktifkan akuisisi video ke buffer bingkai. Perangkat digital-video, video-overlay, dan VCR mengenali perintah ini.

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

_stprintf_s(
  lpszCommand, 
  TEXT("freeze %s %s %s"), 
  lpszDeviceID, 
  lpszFreezeFlags, 
  lpszFlags
);

Parameter

lpszDeviceID

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

lpszFreezeFlags

Bendera yang mengidentifikasi apa yang harus dibekukan. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah bekukan dan bendera yang digunakan oleh setiap jenis.

Nilai	Makna	Makna
digitalvideo	pada persegi panjang	Luar
Overlay	pada persegi panjang
Vcr	bidang Frame	input output

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

Nilai	Makna
pada persegi panjang	Menentukan wilayah yang akan dibekukan. Untuk perangkat video-overlay, wilayah ini akan menonaktifkan akuisisi video. Untuk perangkat video digital, piksel dalam persegi panjang akan mengaktifkan bit masker kuncinya (kecuali bendera "luar" ditentukan). Persegi relatif terhadap asal buffer video dan ditentukan sebagai X1 Y1 X2 Y2. Koordinat X1 Y1 menentukan sudut kiri atas persegi, dan koordinat X2 Y2 menentukan lebar dan tinggi.
bidang	Membekukan bidang pertama. Bidang diasumsikan secara default (jika tidak ada bingkai atau bidang yang ditentukan).
Frame	Membekukan seluruh bingkai, menampilkan kedua bidang.
input	Membekukan bingkai gambar input saat ini, baik dijeda maupun berjalan.
output	Membekukan bingkai output saat ini dari VCR. Jika VCR diputar saat pembekuan dikeluarkan, bingkai saat ini dibekukan dan VCR dijeda. Jika VCR dijeda ketika perintah ini dikeluarkan, bingkai saat ini dibekukan. Gambar yang dibekukan tetap berada di perangkat output hingga perintah pembekuan dikeluarkan. Jika "input" atau "output" tidak ditentukan, "output" diasumsikan.
Luar	Menunjukkan bahwa area di luar wilayah yang ditentukan menggunakan bendera "at" dibekukan.

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

Ketika digunakan dengan perangkat VCR, perintah ini ditujukan untuk kartu pengambilan bingkai.

Untuk menentukan wilayah akuisisi tidak teratur dengan bendera "di", gunakan serangkaian perintah bekukan dan cairkan . Beberapa perangkat video-overlay membatasi kompleksitas wilayah akuisisi.

Perintah ini hanya didukung jika panggilan ke perintah kemampuan dengan bendera "dapat membekukan" mengembalikan TRUE.

Contoh

Perintah berikut menonaktifkan akuisisi video dalam persegi 100 piksel di sudut kiri atas buffer video.

freeze vboard at 0 0 100 100

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
Kemampuan
cairkan

Bagikan melalui