WM_CAP_SET_CALLBACK_YIELD消息

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

WM_CAP_SET_CALLBACK_YIELD 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (fpProc);

parameters

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

如果成功，则返回 TRUE ;如果流式捕获或单帧捕获会话正在进行，则返回 FALSE 。

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

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

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

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

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