ICaptureGraphBuilder2::FindPin 메서드(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
메서드는 FindPin 필터에서 특정 핀을 검색하거나 지정된 핀이 지정된 조건과 일치하는지 여부를 결정합니다.
구문
HRESULT FindPin(
[in] IUnknown *pSource,
[in] PIN_DIRECTION pindir,
[in] const GUID *pCategory,
[in] const GUID *pType,
[in] BOOL fUnconnected,
[in] int num,
[out] IPin **ppPin
);
매개 변수
[in] pSource
필터의 인터페이스 또는 핀의 인터페이스에 대한 포인터입니다.
[in] pindir
핀 방향(입력 또는 출력)을 지정하는 PIN_DIRECTION 열거형의 멤버입니다.
[in] pCategory
Pin 속성 집합에 나열된 핀 범주 중 하나를 지정하는 GUID에 대한 포인터입니다. 범주에 관계없이 핀을 일치하려면 이 매개 변수를 NULL로 설정합니다.
[in] pType
미디어 형식을 지정하는 주 형식 GUID에 대한 포인터입니다. NULL을 사용하여 모든 미디어 형식과 일치합니다.
[in] fUnconnected
핀을 연결 해제해야 하는지 여부를 지정하는 부울 값입니다. TRUE이면 핀을 연결 해제해야 합니다. FALSE이면 핀을 연결하거나 연결할 수 없습니다.
[in] num
일치하는 핀 집합에서 검색할 핀의 인덱스(0부터 시작)입니다. pSource가 필터에 대한 포인터이고 둘 이상의 핀이 검색 조건과 일치하는 경우 이 매개 변수는 검색할 핀을 지정합니다. pSource가 핀에 대한 포인터인 경우 이 매개 변수는 무시됩니다.
[out] ppPin
일치하는 핀의 IPin 인터페이스를 받을 포인터의 주소입니다.
반환 값
일치하는 핀이 있으면 S_OK 반환하거나, 그렇지 않으면 E_FAIL 반환합니다.
설명
pSource가 필터에 대한 포인터인 경우 메서드는 검색 조건과 일치하는 해당 필터에서 n번째 핀을 검색합니다. 여기서 n은 num 매개 변수에 의해 지정됩니다. 메서드가 일치하는 핀을 찾으면 ppPin 매개 변수의 핀에 대한 포인터를 반환합니다.
pSource가 핀에 대한 포인터인 경우 메서드는 검색 조건에 대해 해당 핀을 테스트합니다. 핀이 조건과 일치하면 메서드는 S_OK 반환하고 ppPin 매개 변수에서 핀의 IPin 인터페이스에 대한 포인터를 반환합니다. 그렇지 않으면 E_FAIL 반환합니다.
두 경우 모두 메서드가 성공하면 ppPin 매개 변수에 반환된 IPin 인터페이스에 미해결 참조 수가 있습니다. 사용이 완료되면 인터페이스를 해제해야 합니다.
일반적으로 애플리케이션은 이 메서드를 사용할 필요가 없습니다. ICaptureGraphBuilder2::RenderStream 메서드가 필터 그래프를 빌드할 수 없는 경우 비정상적으로 복잡한 작업에 대해 제공됩니다. 이 메서드를 사용하여 캡처 필터에서 원하는 핀을 검색한 다음 나머지 그래프를 수동으로 빌드합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |
| 라이브러리 | Strmiids.lib |