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