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

싱크 작성기에서 스트림의 입력 형식을 설정합니다.

구문

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

[in] dwStreamIndex

스트림의 인덱스(0부터 시작)입니다. 인덱스는 IMFSinkWriter::AddStream 메서드의 pdwStreamIndex 매개 변수에 의해 수신됩니다.

[in] pInputMediaType

미디어 형식의 IMFMediaType 인터페이스에 대한 포인터입니다. 미디어 형식은 입력 형식을 지정합니다.

[in] pEncodingParameters

특성 저장소의 IMFAttributes 인터페이스에 대한 포인터입니다. 특성 저장소를 사용하여 인코더를 구성합니다. 이 매개 변수는 NULL일 수 있습니다.

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

반환 코드	설명
S_OK	메서드가 성공했습니다.
MF_E_INVALIDMEDIATYPE	기본 미디어 싱크는 형식을 지원하지 않거나 변환이 가능하지 않거나 동적 형식 변경이 불가능합니다.
MF_E_INVALIDSTREAMNUMBER	dwStreamIndex 매개 변수가 잘못되었습니다.
MF_E_TOPO_CODEC_NOT_FOUND	인코딩된 형식의 인코더를 찾을 수 없습니다.

입력 형식은 미디어 싱크에 기록되는 대상 형식과 일치할 필요가 없습니다. 형식이 일치하지 않으면 메서드는 입력 형식에서 대상 형식으로 인코딩할 수 있는 인코더를 로드하려고 시도합니다.

스트리밍이 시작된 후( 즉, IMFSinkWriter::WriteSample에 대한 첫 번째 호출 후) 언제든지 이 메서드를 호출하여 입력 형식을 변경할 수 있습니다. 그러나 기본 인코더 및 미디어 싱크는 동적 형식 변경을 지원해야 합니다.

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

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