ICaptureGraphBuilder::FindInterface 메서드(strmif.h)

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

참고ICaptureGraphBuilder 인터페이스는 더 이상 사용되지 않습니다. 대신 ICaptureGraphBuilder2 를 사용합니다.

 

필터에서 지정된 인터페이스를 찾고, 필터에서 업스트림 및 다운스트림을 찾고, 필요에 따라 지정된 범주의 출력 핀에서만 찾습니다.

구문

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

매개 변수

[in] pCategory

출력 핀 범주를 지정하는 GUID에 대한 포인터입니다. 모든 핀 범주 목록은 Pin 속성 집합 을 참조하세요. NULL 은 범주에 관계없이 모든 출력 핀 검색을 나타냅니다.

[in] pf

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

[in] riid

원하는 인터페이스의 참조 ID입니다.

[out] ppint

void 포인터의 주소입니다. 인터페이스가 발견되면 이 메서드는 ppint 를 초기화하여 찾은 인터페이스에 대한 포인터의 주소를 포함합니다. 인터페이스를 완료하면 Release 메서드를 호출하여 참조 수를 감소합니다.

반환 값

HRESULT 값을 반환합니다.

설명

이 메서드는 필터에서 인터페이스를 찾고 범주가 지정되지 않는 한 필터의 업스트림 및 다운스트림을 찾습니다. 범주가 지정된 경우 해당 범주의 출력 핀의 다운스트림만 확인합니다. 렌더러, 멀티플렉서, TV 튜너, 크로스바 등에서 인터페이스를 찾는 데 사용할 수 있습니다.

pCategory가 &LOOK_UPSTREAM_ONLY 같으면 그래프 작성기가 매개 변수 pf에 지정된 필터의 업스트림 필터 자체나 필터의 다운스트림에는 표시되지 않습니다.

pCategory가 &LOOK_DOWNSTREAM_ONLY 같으면 그래프 작성기가 매개 변수 pf에 지정된 필터의 다운스트림을 표시하지만 필터 자체에는 표시되지 않으며 필터의 업스트림 찾습니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)

추가 정보

오류 및 성공 코드

ICaptureGraphBuilder 인터페이스