macro capSetCallbackOnCapControl (vfw.h)

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

Sintaxe

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

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 foram alocados e todas as outras preparações de captura foram concluídas. Isso fornece 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 captura e um valor retornado da captura de anulações FALSE . 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

Consulte também

de Captura de Vídeo

Macros de Captura de Vídeo

WM_CAP_SET_CALLBACK_CAPCONTROL

capControlCallback