IMFSinkWriter::P laceMarker 메서드(mfreadwrite.h)

지정된 스트림에 마커를 Places.

구문

HRESULT PlaceMarker(
  [in] DWORD  dwStreamIndex,
  [in] LPVOID pvContext
);

매개 변수

[in] dwStreamIndex

스트림의 인덱스(0부터 시작)입니다.

[in] pvContext

애플리케이션 정의 값에 대한 포인터입니다. 이 매개 변수의 값은 호출자의 IMFSinkWriterCallback::OnMarker 콜백 메서드의 pvContext 매개 변수에서 호출자에게 반환됩니다. 애플리케이션은 이 데이터와 연결된 모든 메모리 할당을 담당합니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.
MF_E_INVALIDREQUEST	요청이 잘못되었습니다.

설명

이 메서드를 사용하려면 싱크 작성기를 만들 때 비동기 콜백을 제공해야 합니다. 그렇지 않으면 메서드는 MF_E_INVALIDREQUEST 반환합니다. 자세한 내용은 MF_SINK_WRITER_ASYNC_CALLBACK 참조하세요.

표식은 미디어 싱크가 스트림의 모든 샘플을 특정 지점까지 사용할 때 알림을 받을 수 있는 방법을 제공합니다. 미디어 싱크는 마커 앞에 제공된 모든 샘플을 처리할 때까지 마커를 처리하지 않습니다. 미디어 싱크가 마커를 처리할 때 싱크 작성기는 애플리케이션의 OnMarker 메서드를 호출합니다. 콜백이 호출되면 싱크에서 해당 스트림에 대한 이전 샘플을 모두 사용했음을 알 수 있습니다.

예를 들어 중간 스트림 형식을 변경하려면 형식이 변경되는 지점에서 PlaceMarker 를 호출합니다. OnMarker가 호출되면 IMFSinkWriter::SetInputMediaType을 호출하여 입력 형식을 변경하는 것이 안전합니다(미디어 싱크가 동적 형식 변경을 지원한다고 가정).

내부적으로 이 메서드는 미디어 싱크에서 IMFStreamSink::P laceMarker 를 호출합니다.

참고IMFSinkWriter::P laceMarker 메서드의 pvContext 매개 변수는 IMFStreamSink::P laceMarker 메서드의 pvarContextValue 매개 변수에 전달되지 않습니다. 이러한 두 매개 변수는 직접 관련이 없습니다.

 

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

요구 사항

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

추가 정보

IMFSinkWriter

싱크 작성기