DirectShow DirectShow 레퍼런스 인터페이스 IBaseFilter FindPin [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
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 인터페이스에 미처리의 참조 카운트가 남는다. 다 사용했을 경우는, 인터페이스를 반드시 릴리즈 하는 것.
참조