macro capSetCallbackOnYield (vfw.h)
A macro capSetCallbackOnYield define uma função de retorno de chamada no aplicativo. O AVICap chama esse procedimento quando a janela de captura é gerada durante a captura de streaming. Você pode usar essa macro ou chamar explicitamente a mensagem WM_CAP_SET_CALLBACK_YIELD .
Sintaxe
void capSetCallbackOnYield(
hwnd,
fpProc
);
Parâmetros
hwnd
Manipule para uma janela de captura.
fpProc
Ponteiro para a função de retorno de chamada de rendimento, do tipo capYieldCallback. Especifique NULL para esse parâmetro para desabilitar uma função de retorno de chamada de rendimento instalada anteriormente.
Retornar valor
Nenhum
Comentários
Opcionalmente, os aplicativos podem definir uma função de retorno de chamada de rendimento. A função de retorno de chamada de rendimento é chamada pelo menos uma vez para cada quadro de vídeo capturado durante a captura de streaming. Se uma função de retorno de chamada de rendimento estiver instalada, ela será chamada independentemente do estado do membro fYield da estrutura CAPTUREPARMS .
Se a função de retorno de chamada de rendimento for usada, ela deverá ser instalada antes de iniciar a sessão de captura e permanecer habilitada durante a sessão. Ele pode ser desabilitado após o término da captura de streaming.
Os aplicativos normalmente executam algum tipo de processamento de mensagem na função de retorno de chamada que consiste em um loop PeekMessage, TranslateMessage, DispatchMessage , como no loop de mensagem de uma função WinMain . A função de retorno de chamada de rendimento também deve filtrar e remover mensagens que possam causar problemas de reentrada.
Um aplicativo normalmente retorna TRUE no procedimento de rendimento para continuar a captura de streaming. Se uma função de retorno de chamada de rendimento retornar FALSE, a janela de captura interromperá o processo de captura.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vfw.h |