Compartilhar via


WM_CAP_SET_CALLBACK_YIELD mensagem

A mensagem WM_CAP_SET_CALLBACK_YIELD 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 enviar essa mensagem explicitamente ou usando a macro capSetCallbackOnYield .

WM_CAP_SET_CALLBACK_YIELD 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (fpProc); 

Parâmetros

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 Retornado

Retornará TRUE se tiver êxito ou FALSE se a captura de streaming ou uma sessão de captura de quadro único estiver em andamento.

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]
Cabeçalho
Vfw.h

Confira também

Captura de vídeo

Mensagens de Captura de Vídeo