다음을 통해 공유


ITTerminalSupport::GetDefaultStaticTerminal 메서드(tapi3if.h)

GetDefaultStaticTerminal 메서드는 지정된 미디어 형식에 대한 기본 정적 터미널을 가져옵니다.

구문

HRESULT GetDefaultStaticTerminal(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

매개 변수

[in] lMediaType

필요한 터미널의 미디어 유형입니다.

[in] Direction

터미널 방향의 설명자를 TERMINAL_DIRECTION.

[out] ppTerminal

ITTerminal 인터페이스에 대한 포인터입니다. 사용할 수 있는 터미널이 없으면 NULL입니다.

반환 값

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

의미
S_OK
메서드가 정상적으로 실행되었습니다.
S_FALSE
사용할 수 있는 터미널이 없습니다. *ppTerminalNULL로 반환됩니다.
E_FAIL
알 수 없는 오류입니다.
E_POINTER
lMediaType 매개 변수가 유효한 포인터가 아닙니다.
E_MEDIATYPE
lMediaType 매개 변수가 유효한 미디어 형식이 아닙니다.
E_OUTOFMEMORY
터미널 개체를 만들 메모리가 부족합니다.

설명

이 메서드는 동적 터미널을 반환하지 않습니다. 예를 들어 미디어 형식의 TAPIMEDIATYPE_VIDEO TD_RENDER 터미널 방향은 동적 터미널을 정의합니다. 이 메서드는 이러한 매개 변수로 실패합니다.

이 메서드에서 반환되는 기본 정적 터미널은 ITTerminalSupport::EnumerateStaticTerminals 또는 ITTerminalSupport::get_StaticTerminals 반환되는 정적 터미널 중 하나입니다. 일반적으로 기본 터미널은 제어판 "소리 및 멀티미디어 속성" 애플릿에서 "기본 설정 디바이스"로 선택된 터미널입니다.

TAPI는 ITTerminalSupport::GetDefaultStaticTerminal에서 반환된 ITTerminal 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITTerminal 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

요구 사항

   
대상 플랫폼 Windows
헤더 tapi3if.h(Tapi3.h 포함)

추가 정보

Address 개체

ITTerminalSupport

미디어 유형

TERMINAL_DIRECTION

터미널 개체

터미널 개체 인터페이스