IGraphBuilder::Connect 메서드(strmif.h)

  • 아티클

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

메서드는 Connect 필요한 경우 중간을 사용하여 두 핀을 연결합니다.

구문

HRESULT Connect(
  [in] IPin *ppinOut,
  [in] IPin *ppinIn
);

매개 변수

[in] ppinOut

출력 핀의 IPin 인터페이스에 대한 포인터입니다.

[in] ppinIn

입력 핀의 IPin 인터페이스에 대한 포인터입니다.

반환 값

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

반환 코드 Description
S_OK
 성공.
VFW_S_PARTIAL_RENDER
 부분 성공; 이 핀의 일부 스트림은 지원되지 않는 형식을 사용합니다.
E_ABORT
 작업이 중단되었습니다.
E_POINTER
 NULL 포인터 인수입니다.
VFW_E_CANNOT_CONNECT
 연결을 위해 중간 필터의 조합을 찾을 수 없습니다.
VFW_E_NOT_IN_GRAPH
 하나 이상의 필터가 필터 그래프에 없습니다.

설명

이 메서드는 두 핀을 직접 또는 간접적으로 연결하여 필요한 경우 중간 필터를 추가합니다. 메서드는 직접 연결을 시도하여 시작합니다. 실패하면 필터 그래프에 이미 있고 연결되지 않은 입력 핀이 있는 필터를 사용하려고 시도합니다. (임의 순서로 열거합니다.) 실패하면 레지스트리에서 필터를 검색하고 장점 순서대로 시도합니다. 자세한 내용은 Intelligent Connect를 참조하세요.

연결 프로세스 중에 핀 이름이 바일드(~)로 시작하는 경우 필터 그래프 관리자는 중간 필터의 핀을 무시합니다. 자세한 내용은 PIN_INFO.

요구 사항

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

추가 정보

오류 및 성공 코드

IGraphBuilder 인터페이스