Share via

IBaseFilter::FindPin 메서드(strmif.h)

  • 아티클

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 FindPin 지정된 식별자를 사용하여 핀을 검색합니다.

구문

HRESULT FindPin(
  [in]  LPCWSTR Id,
  [out] IPin    **ppPin
);

매개 변수

[in] Id

핀을 식별하는 상수 와이드 문자 문자열에 대한 포인터입니다. IPin::QueryId 메서드를 호출하여 핀의 식별자를 검색합니다.

[out] ppPin

핀의 IPin 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. 메서드가 실패하면 *ppPin 이 NULL로 설정됩니다.

반환 값

HRESULT 값을 반환합니다. 가능한 값은 다음과 같습니다.

반환 코드 설명
S_OK
 성공.
E_POINTER
 NULL 포인터 인수입니다.
VFW_E_NOT_FOUND
 이 식별자가 있는 핀을 찾을 수 없습니다.

설명

이 메서드는 그래프 지속성을 지원합니다. IPin::QueryId 메서드를 사용하여 핀의 상태를 저장하고 이 메서드를 사용하여 상태를 복원합니다. 핀의 식별자 문자열은 필터 구현에 의해 정의됩니다. 식별자는 필터 내에서 고유해야 합니다.

메서드가 성공하면 반환하는 IPin 인터페이스에 미해결 참조 수가 있습니다. 완료되면 인터페이스를 해제해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 strmif.h(Dshow.h 포함)
라이브러리 Strmiids.lib

추가 정보

오류 및 성공 코드

IBaseFilter 인터페이스