macro capSetCallbackOnYield (vfw.h)

La macro capSetCallbackOnYield establece una función de devolución de llamada en la aplicación. AVICap llama a este procedimiento cuando se produce la ventana de captura durante la captura de streaming. Puede usar esta macro o llamar explícitamente al mensaje WM_CAP_SET_CALLBACK_YIELD .

Sintaxis

BOOL capSetCallbackOnYield(
     hwnd,
     fpProc
);

Parámetros

hwnd

Identificador de una ventana de captura.

fpProc

Puntero a la función de devolución de llamada de rendimiento, de tipo capYieldCallback. Especifique NULL para este parámetro para deshabilitar una función de devolución de llamada de rendimiento instalada anteriormente.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si se ejecuta correctamente o FALSE si la captura de streaming o una sesión de captura de un solo fotograma está en curso.

Observaciones

Las aplicaciones pueden establecer opcionalmente una función de devolución de llamada de rendimiento. La función de devolución de llamada de rendimiento se llama al menos una vez para cada fotograma de vídeo capturado durante la captura de streaming. Si se instala una función de devolución de llamada de rendimiento, se llamará independientemente del estado del miembro fYield de la estructura CAPTUREPARMS .

Si se usa la función de devolución de llamada de rendimiento, debe instalarse antes de iniciar la sesión de captura y debe permanecer habilitada durante la duración de la sesión. Se puede deshabilitar una vez finalizada la captura de streaming.

Las aplicaciones suelen realizar algún tipo de procesamiento de mensajes en la función de devolución de llamada que consta de un bucle PeekMessage, TranslateMessage, DispatchMessage , como en el bucle de mensajes de una función WinMain . La función de devolución de llamada de rendimiento también debe filtrar y quitar mensajes que pueden causar problemas de reentrada.

Normalmente, una aplicación devuelve TRUE en el procedimiento de rendimiento para continuar la captura de streaming. Si una función de devolución de llamada de rendimiento devuelve FALSE, la ventana de captura detiene el proceso de captura.

Requisitos

Consulte también

de captura de vídeo de

Macros de captura de vídeo