IMFCaptureEngine::StartPreview 메서드(mfcaptureengine.h)

  • 아티클

미리 보기를 시작합니다.

구문

HRESULT StartPreview();

반환 값

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

반환 코드 Description
S_OK
 성공.
MF_E_INVALIDREQUEST
 미리 보기 싱크가 초기화되지 않았습니다.

설명

이 메서드를 호출하기 전에 IMFCaptureSink::AddStream을 호출하여 미리 보기 싱크를 구성합니다. 미리 보기 싱크에 대한 포인터를 얻으려면 IMFCaptureEngine::GetSink를 호출합니다.

이 메서드는 비동기적이며, 메서드가 성공 코드를 반환하는 경우 호출자는 IMFCaptureEngineOnEventCallback::OnEvent 메서드를 통해 MF_CAPTURE_ENGINE_PREVIEW_STARTED 이벤트를 수신합니다. 메서드가 성공하면 작업이 비동기적으로 실패할 수 있습니다. 이 경우 오류 코드는 OnEvent 메서드를 통해 전달됩니다.

미리 보기 싱크가 구성되면 IMFCaptureEngine::StopPreview 및 IMFCaptureEngine::StartPreview를 호출하여 미리 보기를 중지하고 시작할 수 있습니다.

요구 사항

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

추가 정보

IMFCaptureEngine