capSetCallbackOnYield 宏 (vfw.h)

capSetCallbackOnYield 宏在应用程序中设置回调函数。当捕获窗口在流式捕获期间生成时，AVICap 将调用此过程。可以使用此宏或显式调用 WM_CAP_SET_CALLBACK_YIELD 消息。

语法

void capSetCallbackOnYield(
   hwnd,
   fpProc
);

hwnd

捕获窗口的句柄。

fpProc

指向 yield 回调函数的指针，类型为 capYieldCallback。为此参数指定 NULL 以禁用以前安装的 yield 回调函数。

无

应用程序可以选择性地设置收益回调函数。对于在流式捕获期间捕获的每个视频帧，至少调用一次 yield 回调函数。如果安装了 yield 回调函数，则将调用它，而不考虑 CAPTUREPARMS 结构的 fYield 成员的状态。

如果使用 yield 回调函数，则必须在启动捕获会话之前安装它，并且必须在会话期间保持启用状态。可以在流式捕获结束后禁用它。

应用程序通常在由 PeekMessage、TranslateMessage、DispatchMessage 循环组成的回调函数中执行某种类型的消息处理，如在 WinMain 函数的消息循环中一样。 yield 回调函数还必须筛选并删除可能导致重新进入问题的消息。

应用程序通常在生成过程中返回 TRUE 以继续流式处理捕获。如果 yield 回调函数返回 FALSE，则捕获窗口将停止捕获过程。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	vfw.h