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

IFilterMapper::RegisterPin

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

레지스트리에 핀의 상세를 기록한다.

구문

HRESULT RegisterPin(
    CLSID Filter,
    LPCWSTR Name,
    BOOL bRendered,
    BOOL bOutput,
    BOOL bZero,
    BOOL bMany,
    CLSID ConnectsToFilter,
    LPCWSTR ConnectsToPin
);

파라미터

Filter

[in] 필터의 GUID.

Name

[in] 핀의 이름. 필터내에서 일의가 아니면 안된다. 타입 정보를 나타내는 것 외에 의미는 없다. 필터의 열거로 문제가 발생하기 위해(때문에), 핀에 99 문자를 넘는 이름을 사용해서는 안 된다.

bRendered

[in] 필터가 이 입력을 렌더링 할지 어떨지를 지정하는 값. 렌더링 하는 경우는, TRUE 를 설정한다. 그 이외의 경우는, FALSE 를 설정한다.

bOutput

[in] 출력 핀인지 아닌지를 지정하는 값. 출력 핀의 경우는, TRUE 를 설정한다. 그 이외의 경우는, FALSE 를 설정한다.

bZero

[in] 이 핀의 인스턴스를 1 개도 가지지 않는 필터를 허락할지 어떨지를 지정하는 값. 허락하는 경우는, TRUE 를 설정한다. 그 이외의 경우는, FALSE 를 설정한다. 예를 들어, 사운드 트랙이 없는 무비의 경우, 디컴프레서필터로 사운드 출력 핀을 생성 할 필요는 없다.

bMany

[in] 이 핀의 인스턴스를 복수 가지는 필터를 허락할지 어떨지를 지정하는 값. 허락하는 경우는, TRUE 를 설정한다. 그 이외의 경우는, FALSE 를 설정한다. 예를 들어, 믹서에는 입력 핀의 인스턴스가 복수 필요하게 된다.

ConnectsToFilter

[in] 예약이 끝난 상태. NULL 이어야 한다. 이 인수는, 필터 그래프 외부에의 접속을 가지는 시스템 규모의 믹서와 같은 필터에서의 사용을 목적으로 하고 있다. 다만, 아직 처리은 되지 않는다.

ConnectsToPin

[in] 예약이 끝난 상태. NULL 이어야 한다.

반환값

HRESULT 값을 돌려준다.

참조

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