capSetCallbackOnYield 宏 （vfw.h）

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

语法

BOOL capSetCallbackOnYield(
     hwnd,
     fpProc
);

参数

hwnd

捕获窗口的句柄。

fpProc

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

返回值

类型： BOOL

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

注解

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

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

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

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

要求

另请参阅

视频捕获

视频捕获宏