DirectShow 보유 사용이 금지되고 있는 인터페이스 ICaptureGraphBuilder FindInterface   [목차열람] [주소복사] [슬롯비우기]

ICaptureGraphBuilder::FindInterface

주 :  ICaptureGraphBuilder 인터페이스의 사용은 피하는 것. 대신에,ICaptureGraphBuilder2 를 사용하는 것.

지정된 인터페이스를 필터, 필터의 업 스트림 및 다운 스트림으로 검색한다. 또, 옵션으로, 지정된 인터페이스를 특정의 카테고리의 출력 핀에서만 검색한다.

구문

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

파라미터

pCategory

[in] 출력 핀 카테고리를 지정하는 GUID 의 포인터. 모든 핀 카테고리의 일람에 대해서는, 「핀 프로퍼티 세트」를 참조할것. NULL 는, 카테고리에 관계없이, 모든 출력 핀을 검색하는 것을 나타낸다.

pf

[in] 필터의 IBaseFilter 인터페이스의 포인터.

riid

[in] 목적의 인터페이스의 참조 식별자.

ppint

[out] void 포인터 주소. 인터페이스가 발견되었을 경우, 이 메서드는 ppint 를 초기화해, 발견된 인터페이스의 포인터 주소를 ppint 에 저장 할 수 있도록(듯이) 한다. 인터페이스를 사용한 후는,Release 메서드를 호출해 참조 카운트를 감소 한다.

반환값

HRESULT 값을 돌려준다.

주의

이 메서드는, 카테고리가 지정되지 않은 한, 필터, 필터의 업 스트림 및 다운 스트림으로 인터페이스를 검색한다. 카테고리가 지정되고 있는 경우, 이 메서드는, 그 카테고리의 출력 핀의 다운 스트림만을 검색의 대상으로 한다. 이 메서드를 사용해, 렌더러, 멀티플렉서, TV 튜너, 크로스바등을 대상으로 해 인터페이스를 검색할 수 있다.

pCategory 가 &LOOK_UPSTREAM_ONLY 인 경우, 그래프 빌더는,pf 인수로 지정되고 있는 필터의 업 스트림을 검색의 대상으로 하지만, 필터 자체나 필터의 다운 스트림은 검색의 대상으로 하지 않는다.

pCategory 가 &LOOK_DOWNSTREAM_ONLY 인 경우, 그래프 빌더는,pf 인수로 지정되고 있는 필터의 다운 스트림을 검색의 대상으로 하지만, 필터 자체나 필터의 업 스트림은 검색의 대상으로 하지 않는다

참조

• 에러 코드와 성공 코드
• ICaptureGraphBuilder 인터페이스