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

IBaseFilter::FindPin

FindPin 메서드는, 지정한 식별자로 핀을 얻어온다.

구문

HRESULT FindPin(
  LPCWSTR Id,
  IPin **ppPin
);

파라미터

Id

[in] 핀을 나타내는 정수의 와이드 캐릭터 캐릭터 라인의 포인터. IPin::QueryId 를 호출해 핀의 식별자를 얻어온다 일.

ppPin

[out] 핀의 IPin 인터페이스의 포인터를 받는 변수의 주소. 메서드가 실패 하면,*ppPin 는 NULL 로 설정된다.

반환값

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

반환 코드 설명
S_OK 성공.
E_POINTER NULL 포인터 인수.
VFW_E_NOT_FOUND 이 식별자를 가지는 핀을 찾아낼 수가 없었다.

주의

이 메서드는 그래프의 영속성을 지원 한다. IPin::QueryId 메서드를 사용해 핀 상태를 세이브해, 이 메서드를 사용해 상태를 복원하는 것. 핀의 식별자 캐릭터 라인은 필터 처리에 의해 정의된다. 식별자는 필터내에서 일의일 필요가 있다.

이 메서드가 성공하면 돌려받는 IPin 인터페이스에 미처리의 참조 카운트가 남는다. 다 사용했을 경우는, 인터페이스를 반드시 릴리즈 하는 것.

참조

↑TOP