DirectShow DirectShow 레퍼런스 DirectShow base class base class 레퍼런스 CBasePin CheckConnect [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
CheckConnect 메서드는, 핀 접속이 적절한가 어떤가를 확인한다.
구문
virtual HRESULT CheckConnect(
IPin *pPin
);
파라미터
pPin
다른 핀의 IPin 인터페이스의 포인터.
반환값
다음 표에 나타낸다, 몇개의 HRESULT 값을 돌려준다.
값 | 설명 |
S_OK | 성공. |
VFW_E_INVALID_DIRECTION | 핀의 방향으로 호환성이 없다. |
주의
이 메서드는 접속 처리의 종료시에 양쪽 모두의 핀으로 호출된다. 접속 핀에서는 CBasePin::Connect 메서드로부터, 수신 핀에서는 CBasePin::ReceiveConnection 메서드로부터 호출된다.
이 메서드를 사용해,pPin 파라미터로 지정한 핀이 접속에 적절하고 있는지를 확인한다. 양쪽 모두의 핀이 같은 향해 (양쪽 모두 입력, 또는 양쪽 모두 출력)인 경우, base class는 에러를 돌려준다. 상속 클래스는 이 메서드를 오버라이드(override) 해, 핀내의 다른 feature를 검증할 수가 있다. 예를 들어,CBaseOutputPin 클래스는 입력 핀에 IMemInputPin 인터페이스를 문의한다.
이 메서드가 실패 하면 접속은 실패해, 핀은 CBasePin::BreakConnect 메서드를 호출한다. CheckConnect 로 취득한 리소스를 릴리즈 하려면 BreakConnect 를 사용하는 것. 예를 들어,CheckConnect 가 QueryInterface 메서드를 호출한다면,BreakConnect 는 그 인터페이스를 릴리즈 해야 한다.
참조