DirectShow DirectShow 레퍼런스 인터페이스 IPin ReceiveConnection   [목차열람] [주소복사] [슬롯비우기]

IPin::ReceiveConnection

ReceiveConnection 메서드는, 다른 핀으로부터의 접속을 허가한다.

애플리케이션으로부터 이 메서드를 호출하지 않는 것. 이 메서드는, 다른 필터가 핀 접속 처리중에 호출한다.

구문

HRESULT ReceiveConnection(
  IPin *pConnector,
  const AM_MEDIA_TYPE *pmt
);

파라미터

pConnector

[in] 접속하고 있는 핀의 IPin 인터페이스의 포인터.

pmt

[in] 접속의 미디어 타입을 지정하는 AM_MEDIA_TYPE 구조체의 포인터.

반환값

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

주의

출력 핀이 접속 하면, 그 출력 핀은 입력 핀에 대해서 이 메서드를 호출한다. 입력 핀은, 지정된 미디어 타입이 받아들이고 가능한가 어떤가를 검증할 필요가 있다. 소유하는 필터에 고유의 그 외의 접속 요건도 체크할 필요가 있는 경우가 있다. 접속에 적절하고 있으면, 입력 핀은 S_OK 를 돌려주어, 다음의 처리도 실행할 필요가 있다.

• IPin::ConnectionMediaType 메서드내에서 미디어 타입을 저장 해, 같은 타입을 돌려준다.
• IPin::ConnectedTo 메서드내에서 출력 핀의 IPin 인터페이스 (pConnector)를 저장 해, 이 포인터를 돌려준다.

접속에 적절하지 않으면, 핀은 에러 코드를 돌려줄 필요가 있다.

CBasePin 클래스는, 미디어 타입 및 IPin 포인터의 저장을 포함한 이 메서드의 기본적인 프레임워크(framework)를 처리 한다.

참조

• 에러 코드와 성공 코드
• 필터의 접속
• IPin 인터페이스