IGraphConfig::SetFilterFlags 메서드(strmif.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 SetFilterFlags 필터의 구성 정보를 설정합니다.

구문

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

매개 변수

[in] pFilter

필터 그래프에서 필터의 IBaseFilter 인터페이스에 대한 포인터입니다.

[in] dwFlags

새 구성 플래그를 지정하는 값입니다. 다음 값 중 하나여야 합니다.

Description
0 플래그가 설정되지 않았습니다.
AM_FILTER_FLAGS_REMOVABLE 동적 다시 연결하는 동안 필터를 이동식으로 사용할 수 있습니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

다음 HRESULT 값 중 하나를 반환합니다.

반환 코드 설명
E_POINTER
NULL 포인터 인수입니다.
E_INVALIDARG
인수가 잘못되었습니다.
S_OK
성공.
VFW_E_NOT_IN_GRAPH
필터가 그래프에 없습니다.

설명

AM_FILTER_FLAGS_REMOVABLE 플래그는 IGraphConfig::Reconnect 메서드의 동작을 변경합니다. Reconnect 메서드는 두 핀 간에 동적 다시 연결을 수행합니다. 호출자가 핀 하나를 지정하지만 다른 핀을 지정하지 않은 경우 다시 연결은 지정된 핀에서 업스트림 또는 다운스트림을 검색하여 적절한 일치 항목을 찾습니다. 그러나 기본적으로 IFilterGraph::AddFilter 메서드를 통해 그래프에 추가된 필터에 도달하면 검색이 실패합니다. 이 동작을 재정의하려면 를 호출 SetFilterFlags 하고 필터에서 AM_FILTER_FLAGS_REMOVABLE 플래그를 설정합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 strmif.h(Dshow.h 포함)
라이브러리 Strmiids.lib

추가 정보

오류 및 성공 코드

IGraphConfig 인터페이스