IGraphConfig 인터페이스(strmif.h)

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

필터 그래프 관리자는 동적 그래프 빌드를 지원하기 위해 노출합니다 IGraphConfig . 이 인터페이스를 사용하면 애플리케이션 및 필터가 그래프가 실행 중 상태이고 스트림에서 데이터를 잃지 않고 필터 그래프를 다시 구성할 수 있습니다.

그래프를 동적으로 다시 빌드하는 가장 간단한 방법은 IGraphConfig::Reconnect 메서드를 호출하는 것입니다. 이 메서드는 그래프를 동적으로 다시 빌드하는 대부분의 세부 정보를 처리합니다. 고유한 기술을 IGraphConfig 구현하려는 상황이 발생하면 IGraphConfig::Reconfigure 메서드도 제공합니다. 이 메서드는 필터 그래프에 대한 잠금을 가져온 다음 애플리케이션에서 콜백 함수를 호출하여 그래프를 다시 구성합니다. 이 메서드를 사용하면 대부분의 작업이 애플리케이션으로 이동됩니다. 자세한 내용은 동적 그래프 빌드를 참조하세요.

필터를 추가하고 제거하는 프로세스를 최적화하기 위해 필터 그래프는 필터 캐시를 유지 관리합니다. Reconnect 메서드를 호출하는 동안 그래프에서 제거된 모든 필터가 캐시에 추가되도록 지정할 수 있습니다. IGraphConfig::AddFilterToCache를 호출하여 필요할 가능성이 있는 경우 캐시에 필터를 직접 추가할 수도 있습니다. IGraphBuilder::Render, IGraphBuilder::RenderFileIGraphBuilder::Connect 메서드는 다른 필터를 사용하기 전에 캐시에서 필터를 자동으로 사용하려고 시도합니다. 또한 다시 연결 메서드에서 캐시된 필터만 다시 연결에 사용되도록 지정할 수 있습니다. 캐시에 보관된 필터는 실제로 그래프의 일부가 아닙니다. 핀의 연결이 끊어지고 중지된 상태로 유지됩니다.

상속

IGraphConfig 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IGraphConfig 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IGraphConfig 인터페이스에는 이러한 메서드가 있습니다.

 
IGraphConfig::AddFilterToCache

AddFilterToCache 메서드는 필터 캐시에 필터를 추가합니다.
IGraphConfig::EnumCacheFilter

EnumCacheFilter 메서드는 필터 캐시의 필터를 열거합니다.
IGraphConfig::GetFilterFlags

GetFilterFlags 메서드는 필터의 구성 정보를 검색합니다.
IGraphConfig::GetStartTime

GetStartTime 메서드는 필터 그래프가 마지막으로 실행 중 상태로 전환되었을 때 사용된 참조 시간을 검색합니다.
IGraphConfig::P ushThroughData

PushThroughData 메서드는 필터 그래프를 통해 지정된 핀으로 데이터를 푸시합니다.
IGraphConfig::Reconfigure

Reconfigure 메서드는 필터 그래프를 잠그고 애플리케이션 또는 필터에서 콜백 함수를 호출하여 동적 재구성을 수행합니다.
IGraphConfig::Reconnect

Reconnect 메서드는 두 핀 간에 동적 다시 연결을 수행합니다.
IGraphConfig::RemoveFilterEx

RemoveFilterEx 메서드는 필터 그래프에서 필터를 제거합니다.
IGraphConfig::RemoveFilterFromCache

RemoveFilterFromCache 메서드는 필터 캐시에서 필터를 제거합니다.
IGraphConfig::SetFilterFlags

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

요구 사항

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