Compartilhar via


macro capSetCallbackOnCapControl (vfw.h)

A macro capSetCallbackOnCapControl define uma função de retorno de chamada no aplicativo, dando a ela um controle de gravação preciso. Você pode usar essa macro ou chamar explicitamente a mensagem WM_CAP_SET_CALLBACK_CAPCONTROL .

Sintaxe

void capSetCallbackOnCapControl(
   hwnd,
   fpProc
);

Parâmetros

hwnd

Manipule para uma janela de captura.

fpProc

Ponteiro para a função de retorno de chamada, do tipo capControlCallback . Especifique NULL para esse parâmetro para desabilitar uma função de retorno de chamada instalada anteriormente.

Valor retornado

Nenhum

Comentários

Uma única função de retorno de chamada é usada para dar ao aplicativo controle preciso sobre os momentos em que a captura de streaming começa e é concluída. A janela de captura primeiro chama o procedimento com nState definido como CONTROLCALLBACK_PREROLL depois que todos os buffers tiverem sido alocados e todas as outras preparações de captura tiverem sido concluídas. Isso dá ao aplicativo a capacidade de pré-registrar fontes de vídeo, retornando da função de retorno de chamada no momento exato em que a gravação deve começar. Um valor retornado de TRUE da função de retorno de chamada continua a ser capturado e um valor retornado de FALSE anula a captura. Após o início da captura, essa função de retorno de chamada será chamada com frequência com nState definido como CONTROLCALLBACK_CAPTURING para permitir que o aplicativo encerre a captura retornando FALSE.

Requisitos

   
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

Macros de Captura de Vídeo

WM_CAP_SET_CALLBACK_CAPCONTROL

capControlCallback