IMFCaptureSink::P repare 메서드(mfcaptureengine.h)

  • 아티클

인코더, 비디오 프로세서 및 미디어 싱크와 같은 필수 파이프라인 구성 요소를 로드하여 캡처 싱크를 준비합니다.

구문

HRESULT Prepare();

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 성공.
MF_E_INVALIDREQUEST
 잘못된 요청입니다.

설명

이 메서드를 호출하는 것은 선택 사항입니다. 이 메서드는 애플리케이션이 사용되기 전에 파이프라인 구성 요소를 구성할 수 있는 기회를 제공합니다. 이 메서드는 비동기 메서드입니다. 메서드가 성공 코드를 반환하는 경우 호출자는 IMFCaptureEngineOnEventCallback::OnEvent 메서드를 통해 MF_CAPTURE_SINK_PREPARED 이벤트를 수신합니다. 이 이벤트가 수신되면 IMFCaptureSink::GetService 를 호출하여 개별 구성 요소를 구성합니다.

이 메서드를 호출하기 전에 하나 이상의 스트림을 추가하여 캡처 싱크를 구성합니다. 스트림을 추가하려면 IMFCaptureSink::AddStream을 호출합니다.

캡처 싱크가 현재 사용 중인 경우 Prepare 메서드가 실패합니다. 예를 들어 캡처 엔진이 현재 미리 보기 상태인 경우 미리 보기 싱크에서 준비 를 호출하면 실패합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfcaptureengine.h

추가 정보

IMFCaptureSink