Share via

ITStream::SelectTerminal 메서드(tapi3if.h)

  • 아티클

SelectTerminal 메서드는 스트림에 대한 ITTerminal 개체를 선택합니다.

구문

HRESULT SelectTerminal(
  [in] ITTerminal *pTerminal
);

매개 변수

[in] pTerminal

선택한 터미널의 ITTerminal 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값 의미
S_OK
 메서드가 정상적으로 실행되었습니다.
E_POINTER
 pTerminal 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
 메모리가 부족하여 작업을 수행할 수 없습니다.
TAPI_E_MAXTERMINALS
 스트림에서 여러 터미널이 선택되었지만 미디어 혼합 또는 분할은 불가능합니다.
TAPI_E_INVALIDTERMINAL
 선택한 터미널이 잘못되었습니다.

설명

전송이 미디어를 스트리밍할 수 있는 상태인지 여부에 관계없이 언제든지 터미널을 선택할 수 있습니다. 전송이 미디어를 스트리밍할 수 있는 상태이고 애플리케이션이 스트림에서 ITStream::P auseStream 또는 ITStream::StopStream을 성공적으로 호출하지 않았거나 이 스트림에 대해 ITStream::P auseStream 또는 ITStream::StopStream을 성공적으로 호출한 것보다 더 최근에 이 스트림에 대해 ITStream::StartStream을 성공적으로 호출한 경우 터미널이 선택되는 즉시 스트리밍이 자동으로 시작됩니다. 전송이 미디어를 스트리밍할 수 있는 상태로 들어가기 전에 스트림에서 터미널을 선택하고 StopStream 또는 PauseStream 에 대한 후속 호출이 이루어지지 않으면 전송이 미디어를 스트리밍할 수 있는 상태가 되면 스트림이 자동으로 시작됩니다.

CME_STREAM_ACTIVE 이벤트는 스트리밍이 실제로 시작될 때 생성되며 SelectTerminal 호출 이후일 수 있습니다. CME_STREAM_FAIL 또는 CME_TERMINAL_FAIL 이벤트는 스트리밍이 실제로 실패할 때 생성되며 SelectTerminal 호출 이후일 수도 있습니다.

ITTerminal::get_MediaType 결과가 ITStream::get_MediaType 일치하는 경우에만 스트림에서 터미널을 선택할 수 있습니다. 또한 일부 MSP는 ITTerminal::get_Direction 및 ITStream::get_Direction 간에 일치해야 할 수 있지만 인터페이스는 이를 적용하지 않습니다.

일부 MSP는 특정 수의 터미널(일반적으로 하나)을 동일한 스트림에서 동시에 선택하는 것을 허용하지 않을 수 있지만 인터페이스 자체는 이러한 제한을 적용하지 않습니다. 예를 들어, 한 쌍의 스피커에서 스트림을 수신하는 동안 들어오는 오디오 스트림을 파일에 기록할 수 있도록 허용하기 위해 동일한 스트림에서 한 번에 여러 터미널을 선택하는 것이 유용합니다.

지정된 터미널은 하나의 스트림에서만 선택할 수 있습니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi3if.h(Tapi3.h 포함)

추가 정보

ITStream

MSPI(Media Service Provider Interface)