IPin 인터페이스(strmif.h)

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

이 인터페이스는 모든 입력 및 출력 핀에 의해 노출됩니다.

필터 그래프 관리자는 이 인터페이스를 사용하여 핀을 연결하고 플러시 작업을 수행합니다. 애플리케이션은 이 인터페이스를 사용하여 핀에 정보를 쿼리할 수 있습니다. 애플리케이션은 연결, 연결 끊기, BeginFlush 또는 EndFlush와 같은 핀 상태를 변경하는 메서드를 호출 IPin 해서는 안 됩니다. 핀을 연결하려면 애플리케이션에서 IGraphBuilder의 메서드를 사용해야 합니다.

필터 개발자: CBasePin, CBaseInputPin 및 CBaseOutputPin 클래스는 이 인터페이스를 구현합니다. 다른 기본 클래스는 이러한 세 클래스에서 파생됩니다.

상속

IPin 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IPin 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IPin 인터페이스에는 이러한 메서드가 있습니다.

IPin::BeginFlush BeginFlush 메서드는 플러시 작업을 시작합니다. (IPin.BeginFlush)
IPin::Connect Connect 메서드는 핀을 다른 핀에 연결합니다.
IPin::ConnectedTo ConnectedTo 메서드는 연결된 핀에 대한 포인터(있는 경우)를 검색합니다.
IPin::ConnectionMediaType ConnectionMediaType 메서드는 현재 핀 연결에 대한 미디어 형식(있는 경우)을 검색합니다.
IPin::D sconnect Disconnect 메서드는 현재 핀 연결을 끊습니다.
IPin::EndFlush EndFlush 메서드는 플러시 작업을 종료합니다. (IPin.EndFlush)
IPin::EndOfStream EndOfStream 메서드는 필터에 새 실행 명령이 실행될 때까지 추가 데이터가 필요하지 않음을 핀에 알릴 수 있습니다.
IPin::EnumMediaTypes EnumMediaTypes 메서드는 핀의 기본 설정 미디어 형식을 열거합니다.
IPin::NewSegment NewSegment 메서드는 이 호출 후 받은 미디어 샘플이 일반적인 시작 시간, 중지 시간 및 속도와 함께 세그먼트로 그룹화된다는 것을 핀에 알 수 있습니다.
IPin::QueryAccept QueryAccept 메서드는 핀이 지정된 미디어 형식을 허용하는지 여부를 결정합니다.
IPin::QueryDirection QueryDirection 메서드는 핀의 방향(입력 또는 출력)을 가져옵니다.
IPin::QueryId QueryId 메서드는 핀의 식별자를 검색합니다.
IPin::QueryInternalConnections QueryInternalConnections 메서드는 필터 내에서 이 핀에 내부적으로 연결된 핀을 검색합니다.
IPin::QueryPinInfo QueryPinInfo 메서드는 핀에 대한 정보를 검색합니다.
IPin::ReceiveConnection ReceiveConnection 메서드는 다른 핀의 연결을 허용합니다.

요구 사항

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