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

BOOL 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.

Valor de retorno

Tipo: BOOL

Retornará TRUE se bem-sucedido ou FALSE se a captura de streaming ou uma sessão de captura de quadro único estiver em andamento.

Observações

Os aplicativos podem, opcionalmente, 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 ela deverá 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

Consulte também

de Captura de Vídeo

Macros de Captura de Vídeo