capSetCallbackOnYield macro (vfw.h)

Макрос capSetCallbackOnYield задает функцию обратного вызова в приложении. AVICap вызывает эту процедуру, когда окно захвата возвращается во время потоковой записи. Этот макрос можно использовать или явно вызывать сообщение WM_CAP_SET_CALLBACK_YIELD .

Синтаксис

BOOL capSetCallbackOnYield(
     hwnd,
     fpProc
);

Параметры

hwnd

Дескриптор в окне захвата.

fpProc

Указатель на функцию обратного вызова выходного типа capYieldCallback. Укажите ЗНАЧЕНИЕ NULL для этого параметра, чтобы отключить ранее установленную функцию обратного вызова.

Возвращаемое значение

Тип: BOOL

Возвращает значение TRUE , если выполняется успешное или ложное значение, если потоковая запись или сеанс записи с одним кадром выполняется.

Замечания

Приложения могут при необходимости задать функцию обратного вызова доходности. Функция обратного вызова доходности вызывается по крайней мере один раз для каждого кадра видео, захваченного во время потоковой записи. Если установлена функция обратного вызова, она будет вызываться независимо от состояния элемента FYield структуры CAPTUREPARMS .

Если используется функция обратного вызова, ее необходимо установить перед запуском сеанса записи, и она должна оставаться включенной в течение сеанса. Его можно отключить после завершения потоковой записи.

Приложения обычно выполняют некоторые типы обработки сообщений в функции обратного вызова, состоящей из цикла обратного вызова PeekMessage, TranslateMessage, DispatchMessage , как в цикле сообщений функции WinMain . Функция обратного вызова должна также фильтровать и удалять сообщения, которые могут вызвать проблемы повторного входа.

Приложение обычно возвращает значение TRUE в процедуре получения данных для продолжения потоковой передачи. Если функция обратного вызова возвращает значение FALSE, окно записи останавливает процесс записи.

Требования

См. также

Запись видео

Макросы записи видео