IDistributorNotify 인터페이스(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
IDistributorNotify 인터페이스를 사용하면 필터 그래프가 변경될 때 플러그 인 배포자를 알 수 있습니다.
애플리케이션은 이 인터페이스를 사용하지 않습니다. PID(플러그 인 배포자)를 작성하고 PID가 필터 그래프 구성의 제어 및 변경 내용에 대한 알림을 수신하도록 하려면 이 인터페이스를 구현합니다.
Filter Graph Manager는 집계하는 플러그 인 배포자에서 이 인터페이스를 쿼리합니다. PID가 이 인터페이스를 노출하는 경우 필터 그래프 관리자는 필터에서 해당하는 IBaseFilter 메서드를 호출하기 전에 IDistributorNotify 메서드를 호출하여 PID에 상태 변경 내용을 알 수 있습니다. 필터 그래프 관리자는 필터를 추가하거나 제거하거나 핀 연결이 변경될 때마다 IDistributorNotify::NotifyGraphChange 메서드를 호출합니다.
IDistributorNotify 메서드를 호출하는 동안 에는 Filter Graph Manager에서 메서드를 호출하는 다른 코드 경로에서 보유할 수 있는 중요한 섹션이 없습니다. 이렇게 하면 교착 상태가 발생할 수 있습니다.
상속
IDistributorNotify 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IDistributorNotify 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IDistributorNotify 인터페이스에는 이러한 메서드가 있습니다.
| IDistributorNotify::NotifyGraphChange NotifyGraphChange 메서드는 필터 그래프의 필터 집합이 변경되거나 핀 연결이 변경되면 호출됩니다. |
| IDistributorNotify::P ause Pause 메서드는 필터 그래프가 일시 중지된 상태로 들어갈 때 호출됩니다. |
| IDistributorNotify::Run 필터 그래프가 실행 중 상태로 들어갈 때 Run 메서드가 호출됩니다. |
| IDistributorNotify::SetSyncSource SetSyncSource 메서드는 새 클록이 등록될 때 호출됩니다. |
| IDistributorNotify::Stop Stop 메서드는 필터 그래프가 중지된 상태로 들어갈 때 호출됩니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |