capSetCallbackOnYield 매크로(vfw.h)
capSetCallbackOnYield 매크로는 애플리케이션에서 콜백 함수를 설정합니다. AVICap은 스트리밍 캡처 중에 캡처 창이 생성되면 이 절차를 호출합니다. 이 매크로를 사용하거나 WM_CAP_SET_CALLBACK_YIELD 메시지를 명시적으로 호출할 수 있습니다.
구문
void capSetCallbackOnYield(
hwnd,
fpProc
);
매개 변수
hwnd
캡처 창에 대한 핸들입니다.
fpProc
capYieldCallback 형식의 수익률 콜백 함수에 대한 포인터입니다. 이전에 설치된 yield 콜백 함수를 사용하지 않도록 설정하려면 이 매개 변수에 NULL 을 지정합니다.
반환 값
없음
설명
애플리케이션은 선택적으로 수익률 콜백 함수를 설정할 수 있습니다. 출력 콜백 함수는 스트리밍 캡처 중에 캡처된 각 비디오 프레임에 대해 한 번 이상 호출됩니다. yield 콜백 함수가 설치된 경우 CAPTUREPARMS 구조체의 fYield 멤버 상태에 관계없이 호출됩니다.
yield 콜백 함수를 사용하는 경우 캡처 세션을 시작하기 전에 설치해야 하며 세션 기간 동안 사용하도록 설정해야 합니다. 스트리밍 캡처가 종료된 후 사용하지 않도록 설정할 수 있습니다.
애플리케이션은 일반적으로 WinMain 함수의 메시지 루프와 같이 PeekMessage, TranslateMessage, DispatchMessage 루프로 구성된 콜백 함수에서 일부 유형의 메시지 처리를 수행합니다. 또한 yield 콜백 함수는 재진입 문제를 일으킬 수 있는 메시지를 필터링하고 제거해야 합니다.
애플리케이션은 일반적으로 스트리밍 캡처를 계속하기 위해 생성 프로시저에서 TRUE 를 반환합니다. yield 콜백 함수가 FALSE를 반환하면 캡처 창이 캡처 프로세스를 중지합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | vfw.h |