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 |