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

Consulte también

Captura de vídeo

Macros de captura de vídeo