IMFSequencerSource::GetPresentationContext 메서드(mfidl.h)

프레젠테이션 설명자를 연결된 시퀀서 요소 식별자와 프레젠테이션이 나타내는 토폴로지에 매핑합니다.

구문

HRESULT GetPresentationContext(
  [in]  IMFPresentationDescriptor *pPD,
  [out] MFSequencerElementId      *pId,
  [out] IMFTopology               **ppTopology
);

매개 변수

[in] pPD

프레젠테이션 설명자의 IMFPresentationDescriptor 인터페이스에 대한 포인터입니다.

[out] pId

sequencer 요소 식별자를 받습니다. 이 값은 애플리케이션이 IMFSequencerSource::AppendTopology를 호출할 때 시퀀서 소스에 의해 할당됩니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[out] ppTopology

애플리케이션이 시퀀서 원본에 추가한 원래 토폴로지의 IMFTopology 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다. 시퀀서 원본이 다음 프레젠테이션으로 전환된 경우 이 매개 변수는 NULL 값을 받을 수 있습니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	프레젠테이션 설명자가 잘못되었습니다.
MF_S_SEQUENCER_CONTEXT_CANCELED	이 세그먼트가 취소되었습니다.

설명

ppTopology에서 반환되는 토폴로지는 애플리케이션이 AppendTopology에 지정한 원래 토폴로지입니다. 이 토폴로지의 원본 노드에는 네이티브 원본에 대한 포인터가 포함됩니다. 미디어 세션에서 이 토폴로지를 큐에 대기하지 마세요. 대신 IMFMediaSourceTopologyProvider::GetMediaSourceTopology 를 호출하여 시퀀서 원본의 수정된 토폴로지를 가져옵니다. 수정된 토폴로지의 원본 노드에는 네이티브 원본이 아닌 시퀀서 원본에 대한 포인터가 포함됩니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfidl.h
라이브러리	Mfuuid.lib

참고 항목

IMFSequencerSource

Sequencer 원본