DirectShow DirectShow 레퍼런스 인터페이스 IGraphBuilder Connect   [목차열람] [주소복사] [슬롯비우기]
IGraphBuilder::Connect
 
Microsoft DirectX 9.0

IGraphBuilder::Connect

Connect 메서드는, 2 개의 핀을 접속한다 (필요에 따라서 중간 필터를 사용).

구문

HRESULT Connect(
  IPin *ppinOut,
  IPin *ppinIn
);

파라미터

ppinOut

[in] 출력 핀의 IPin 인터페이스의 포인터.

ppinIn

[in] 입력 핀의 IPin 인터페이스의 포인터.

반환값

HRESULT 를 돌려준다. 가능한 값은 다음과 같다.

값 설명
S_OK 성공.
VFW_S_PARTIAL_RENDER 불완전한 성공. 이 핀으로부터의 스트림의 일부가 지원되지 않은 포맷을 사용하고 있다.
E_ABORT 조작이 중지되었다.
E_POINTER NULL 포인터 인수.
VFW_E_CANNOT_CONNECT 접속을 확립하는 중간 필터의 편성이 발견되지 않았다.
VFW_E_NOT_IN_GRAPH 적어도 1 개의 필터가 필터 그래프에 포함되지 않았다.

주의

이 메서드는, 2 개의 핀을 직접 접속하는지, 또는 필요에 따라서 중간 필터를 추가해 간접적으로 접속한다. 이 메서드는 우선, 직접 접속을 시도하는 것으로부터 시작 한다. 그 시도에 실패 하면, 필터 그래프에 이미 포함되어 있어, 접속되지 않은 입력 핀을 가지는 임의의 필터를 사용하려고 시도한다 (이 때 열거의 순서는 임의이다). 실패 하면, 레지스트리내의 필터를 메리트의 순서에 검색하려고 시도한다. 더 자세한 정보는, 「인텔리전트 접속」을 참조할것.

접속 처리에서는, 중간 필터의 핀명이 ~ (tilde)로 시작되는 경우, 필터 그래프 매니저는 그 필터의 핀을 무시한다. 더 자세한 정보는, 「PIN_INFO 」를 참조할것.

참조

↑TOP