IMFTopologyNode::ConnectOutput 메서드(mfidl.h)

  • 아티클

이 노드의 출력 스트림을 다른 노드의 입력 스트림에 연결합니다.

구문

HRESULT ConnectOutput(
  [in] DWORD           dwOutputIndex,
  [in] IMFTopologyNode *pDownstreamNode,
  [in] DWORD           dwInputIndexOnDownstreamNode
);

매개 변수

[in] dwOutputIndex

이 노드의 출력 스트림 인덱스(0부터 시작)입니다.

[in] pDownstreamNode

연결할 노드의 IMFTopologyNode 인터페이스에 대한 포인터입니다.

[in] dwInputIndexOnDownstreamNode

다른 노드에 있는 입력 스트림의 인덱스(0부터 시작)입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_FAIL
 메서드가 실패했습니다.
E_INVALIDARG
 잘못된 매개 변수입니다.

설명

노드 연결은 한 노드에서 다음 노드로의 데이터 흐름을 나타냅니다. 스트림은 논리적이며 인덱스로 지정됩니다.

노드가 지정된 출력에 이미 연결된 경우 메서드는 기존 연결을 끊습니다. dwOutputIndex 또는 dwInputIndexOnDownstreamNode가 아직 존재하지 않는 스트림을 지정하는 경우 메서드는 필요한 만큼 스트림을 추가합니다.

이 메서드는 잘못된 특정 조건을 확인합니다.

  • 출력 노드에는 출력 연결이 있을 수 없습니다. 출력 노드에서 이 메서드를 호출하면 메서드는 E_FAIL 반환합니다.
  • 노드는 자체에 연결할 수 없습니다. pDownstreamNode가 메서드 호출과 동일한 노드를 지정하면 메서드는 E_INVALIDARG 반환합니다.
그러나 메서드가 성공하는 경우 노드 연결이 유효하다고 보장하지는 않습니다. 토폴로지 로더가 resolve 수 없는 부분 토폴로지를 만들 수 있습니다. 그렇다면 IMFTopoLoader::Load 메서드가 실패합니다.

기존 노드 연결을 끊려면 IMFTopologyNode::D isconnectOutput을 호출합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfuuid.lib

참고 항목

IMFTopologyNode

토폴로지