IMFMediaSink::GetCharacteristics 메서드(mfidl.h)

  • 아티클

미디어 싱크의 특성을 가져옵니다.

구문

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

매개 변수

[out] pdwCharacteristics

0개 이상의 플래그의 비트 OR 를 받습니다. 다음 플래그가 정의됩니다.

값 의미
MEDIASINK_FIXED_STREAMS
0x00000001
 미디어 싱크에는 고정된 개수의 스트림이 있습니다. IMFMediaSink::AddStreamSink 및 IMFMediaSink::RemoveStreamSink 메서드를 지원하지 않습니다. 이 플래그는 애플리케이션에 대한 힌트입니다.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 미디어 싱크는 외부 클록과 속도를 일치시킬 수 없습니다.

최상의 결과를 위해 이 미디어 싱크를 프레젠테이션 시계의 시간 원본으로 사용해야 합니다. 다른 시간 원본을 사용하는 경우 미디어 싱크는 낮은 결과(예: 결함)로 시계와 속도를 일치시킬 수 없습니다.

이 플래그는 파이프라인을 구성하는 방법을 제한하기 때문에 드물게 사용해야 합니다.

프레젠테이션 시계에 대한 자세한 내용은 프레젠테이션 시계를 참조하세요.
MEDIASINK_RATELESS
0x00000004
 미디어 싱크는 속도가 없습니다. 가능한 한 빨리 샘플을 사용하며 프레젠테이션 시계에 동기화되지 않습니다.

대부분의 보관 싱크는 속도가 없습니다.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 미디어 싱크에는 프레젠테이션 시계가 필요합니다. 프레젠테이션 시계는 미디어 싱크의 IMFMediaSink::SetPresentationClock 메서드를 호출하여 설정됩니다.

미디어 싱크가 시계(속도 없는 미디어 싱크에서와 같이)를 무시하는 경우에도 모든 미디어 싱크가 SetPresentationClock 메서드를 지원해야 하므로 이 플래그는 사용되지 않습니다.
MEDIASINK_CAN_PREROLL
0x00000010
 미디어 싱크는 프레젠테이션 시계가 시작되기 전에 사전 등록 샘플을 수락할 수 있습니다. 미디어 싱크는 IMFMediaSinkPreroll 인터페이스를 노출합니다.
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 첫 번째 스트림 싱크(인덱스 0)는 참조 스트림입니다. 다른 스트림 싱크에서 미디어 형식을 설정하려면 먼저 참조 스트림에 미디어 형식이 있어야 합니다.

반환 값

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

반환 코드 설명
S_OK
 메서드가 성공했습니다.
MF_E_SHUTDOWN
 미디어 싱크의 Shutdown 메서드가 호출되었습니다.

설명

미디어 싱크의 특성은 싱크의 수명 시간 동안 고정됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfuuid.lib

추가 정보

IMFMediaSink

미디어 싱크