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

  • 아티클

미디어 싱크에서 스트림 싱크를 제거합니다.

구문

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

매개 변수

[in] dwStreamSinkIdentifier

제거할 스트림의 식별자입니다. 스트림 식별자는 IMFMediaSink::AddStreamSink 를 호출하여 스트림 싱크를 추가할 때 정의됩니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_INVALIDARG
 이 특정 스트림 싱크는 제거할 수 없습니다.
MF_E_INVALIDSTREAMNUMBER
 스트림 번호가 잘못되었습니다.
MF_E_NOT_INITIALIZED
 미디어 싱크가 초기화되지 않았습니다.
MF_E_SHUTDOWN
 미디어 싱크의 Shutdown 메서드가 호출되었습니다.
MF_E_STREAMSINKS_FIXED
 이 미디어 싱크에는 고정된 스트림 싱크 집합이 있습니다. Stream 싱크를 제거할 수 없습니다.

설명

이 메서드가 호출되면 해당 스트림 싱크 개체가 더 이상 유효하지 않습니다. IMFMediaSink::GetStreamSinkByIndex 및 IMFMediaSink::GetStreamSinkById 메서드는 더 이상 해당 스트림 싱크를 반환하지 않습니다. AddStreamSink를 호출하여 다른 스트림을 추가하는 경우 스트림 식별자를 다시 사용할 수 있습니다.

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

경우에 따라 미디어 싱크는 이 메서드를 지원하지만 모든 스트림 싱크를 제거할 수는 없습니다. 예를 들어 스트림 0을 제거하도록 허용하지 않을 수 있습니다.

요구 사항

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

추가 정보

IMFMediaSink

미디어 싱크