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

미디어 싱크에 새 스트림 싱크를 추가합니다.

구문

HRESULT AddStreamSink(
  [in]  DWORD         dwStreamSinkIdentifier,
  [in]  IMFMediaType  *pMediaType,
  [out] IMFStreamSink **ppStreamSink
);

[in] dwStreamSinkIdentifier

새 스트림의 식별자입니다. 값은 임의이지만 고유해야 합니다.

[in] pMediaType

스트림의 미디어 형식을 지정하는 IMFMediaType 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[out] ppStreamSink

새 스트림 싱크의 IMFStreamSink 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_INVALIDSTREAMNUMBER	지정된 스트림 식별자가 잘못되었습니다.
MF_E_SHUTDOWN	미디어 싱크의 Shutdown 메서드가 호출되었습니다.
MF_E_STREAMSINK_EXISTS	동일한 스트림 식별자를 가진 스트림 싱크가 이미 있습니다.
MF_E_STREAMSINKS_FIXED	이 미디어 싱크에는 고정된 스트림 싱크 집합이 있습니다. 새 스트림 싱크를 추가할 수 없습니다.

모든 미디어 싱크가 이 메서드를 지원하는 것은 아닙니다. 미디어 싱크가 이 메서드를 지원하지 않는 경우 IMFMediaSink::GetCharacteristics 메서드는 MEDIASINK_FIXED_STREAMS 플래그를 반환합니다.

pMediaType이 NULL인 경우 IMFMediaTypeHandler 인터페이스를 사용하여 미디어 형식을 설정합니다. IMFStreamSink::GetMediaTypeHandler를 호출하여 인터페이스에 대한 포인터를 가져옵니다.