Compartilhar via


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

Confira também

Captura de vídeo

Funções de captura de vídeo