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 [仅限桌面应用] |
标头 |
|