Поделиться через


сообщение WM_CAP_SET_CALLBACK_YIELD

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

WM_CAP_SET_CALLBACK_YIELD 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (fpProc); 

Параметры

fpProc

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

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

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

Комментарии

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

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

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

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

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Vfw.h

См. также раздел

Захват видео

Сообщения для захвата видео