capSetCallbackOnYield makro (vfw.h)

  • Artikel

Makro capSetCallbackOnYield mengatur fungsi panggilan balik dalam aplikasi. AVICap memanggil prosedur ini ketika jendela pengambilan menghasilkan selama penangkapan streaming. Anda dapat menggunakan makro ini atau secara eksplisit memanggil pesan WM_CAP_SET_CALLBACK_YIELD .

Sintaks

void capSetCallbackOnYield(
   hwnd,
   fpProc
);

Parameter

hwnd

Menangani ke jendela pengambilan.

fpProc

Penunjuk ke fungsi panggilan balik hasil, jenis capYieldCallback. Tentukan NULL untuk parameter ini untuk menonaktifkan fungsi panggilan balik hasil yang diinstal sebelumnya.

Mengembalikan nilai

Tidak ada

Keterangan

Aplikasi dapat secara opsional mengatur fungsi panggilan balik hasil. Fungsi panggilan balik hasil dipanggil setidaknya sekali untuk setiap bingkai video yang diambil selama pengambilan streaming. Jika fungsi panggilan balik hasil diinstal, fungsi tersebut akan dipanggil terlepas dari status anggota fYield dari struktur CAPTUREPARMS .

Jika fungsi panggilan balik hasil digunakan, fungsi tersebut harus diinstal sebelum memulai sesi pengambilan dan harus tetap diaktifkan selama durasi sesi. Ini dapat dinonaktifkan setelah pengambilan streaming berakhir.

Aplikasi biasanya melakukan beberapa jenis pemrosesan pesan dalam fungsi panggilan balik yang terdiri dari PeekMessage, TranslateMessage, perulangan DispatchMessage , seperti dalam perulangan pesan fungsi WinMain . Fungsi panggilan balik hasil juga harus memfilter dan menghapus pesan yang dapat menyebabkan masalah reentrancy.

Aplikasi biasanya mengembalikan TRUE dalam prosedur hasil untuk melanjutkan pengambilan streaming. Jika fungsi panggilan balik hasil mengembalikan FALSE, jendela pengambilan akan menghentikan proses pengambilan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header vfw.h

Lihat juga

Pengambilan Video

Makro Penangkapan Video