다음을 통해 공유

IMFSinkWriter::Finalize 메서드(mfreadwrite.h)

  • 아티클

싱크 작성기에 대한 모든 쓰기 작업을 완료합니다.

구문

HRESULT Finalize();

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

모든 입력 샘플을 싱크 작성기에 보낸 후 이 메서드를 호출합니다. 메서드는 미디어 싱크에서 최종 출력을 만드는 데 필요한 모든 작업을 수행합니다.

싱크 작성기를 만들 때 콜백 인터페이스를 제공하는 경우 이 메서드는 비동기적으로 완료됩니다. 작업이 완료되면 콜 백의 IMFSinkWriterCallback::OnFinalize 메서드가 호출됩니다. 자세한 내용은 MF_SINK_WRITER_ASYNC_CALLBACK 참조하세요. 그렇지 않으면 콜백을 제공하지 않으면 Finalize 메서드는 작업이 완료될 때까지 차단됩니다.

내부적으로 이 메서드는 IMFStreamSink::P laceMarker 를 호출하여 미디어 싱크의 각 스트림에 대한 세그먼트 끝 마커를 배치합니다. 또한 미디어 싱크 가 IMFFinalizableMediaSink 인터페이스를 지원하는 경우 IMFFinalizableMediaSink::BeginFinalize 및 EndFinalize 를 호출 합니다 .

이 메서드가 호출되면 다음 메서드가 실패합니다.

Finalize를 호출하지 않으면 미디어 싱크의 출력이 불완전하거나 유효하지 않을 수 있습니다. 예를 들어 필수 파일 헤더가 출력 파일에서 누락될 수 있습니다.

이 인터페이스는 Windows Vista용 플랫폼 업데이트 보충이 설치된 경우 Windows Vista에서 사용할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista용 Windows 7, Windows Vista 및 플랫폼 업데이트 보충 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfreadwrite.h

추가 정보

IMFSinkWriter

싱크 작성기