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、TranslateMessageDispatchMessage 循环组成的回调函数中执行某种类型的消息处理,如在 WinMain 函数的消息循环中一样。 yield 回调函数还必须筛选并删除可能导致重新进入问题的消息。

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

要求

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

请参阅

视频捕获

视频捕获消息