Função de retorno de chamada CAPCONTROLCALLBACK (vfw.h)
A função capControlCallback é a função de retorno de chamada usada para o controle de precisão iniciar e encerrar a captura de streaming. O nome capControlCallback é um espaço reservado para o nome da função fornecida pelo aplicativo.
Para definir o retorno de chamada, envie a mensagem WM_CAP_SET_CALLBACK_CAPCONTROL para a janela de captura ou chame a macro capSetCallbackOnCapControl .
Sintaxe
CAPCONTROLCALLBACK Capcontrolcallback;
LRESULT Capcontrolcallback(
HWND hWnd,
int nState
)
{...}
Parâmetros
hWnd
Identificador para a janela de captura associada à função de retorno de chamada.
nState
Estado atual da operação de captura. O valor CONTROLCALLBACK_PREROLL é enviado inicialmente para habilitar o pré-registro das fontes de vídeo e retornar o controle para o aplicativo de captura no momento exato em que a gravação deve começar. O valor CONTROLCALLBACK_CAPTURING é enviado uma vez por quadro capturado para indicar que a captura de streaming está em andamento e para permitir que o aplicativo encerre a captura.
Retornar valor
Quando nState é definido como CONTROLCALLBACK_PREROLL, essa função de retorno de chamada deve retornar TRUE para iniciar a captura ou FALSE para anula-la. Quando nState é definido como CONTROLCALLBACK_CAPTURING, essa função de retorno de chamada deve retornar TRUE para continuar a captura ou FALSE para encerrá-la.
Comentários
A primeira mensagem enviada ao procedimento de retorno de chamada define o parâmetro nState como CONTROLCALLBACK_PREROLL depois que a alocação de todos os buffers e todas as outras preparações de captura são concluídas.
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 |