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 la ventana de captura produce durante la captura de streaming. Puede usar esta macro o llamar explícitamente al mensaje WM_CAP_SET_CALLBACK_YIELD .
Sintaxis
void 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
None
Observaciones
Las aplicaciones pueden establecer opcionalmente una función de devolución de llamada de rendimiento. La función de devolución de llamada yield 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 yield, debe instalarse antes de iniciar la sesión de captura y debe permanecer habilitada durante la sesión. Se puede deshabilitar una vez finalizada la captura de streaming.
Normalmente, las aplicaciones realizan 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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vfw.h |