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

아티클
08/26/2023

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	사용할 수 있는 터미널이 없습니다. *ppTerminal 은 NULL로 반환됩니다.
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를 호출하여 연결된 리소스를 해제해야 합니다.