Метод 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	Для создания объекта Terminal недостаточно памяти.

Этот метод не возвращает динамические терминалы. Например, наличие типа носителя TAPIMEDIATYPE_VIDEO и направление терминала TD_RENDER определяет динамический терминал; Этот метод завершится ошибкой с этими параметрами.

Статический терминал по умолчанию, возвращаемый этим методом, является одним из статических терминалов, возвращаемых ITTerminalSupport::EnumerateStaticTerminals или ITTerminalSupport::get_StaticTerminals. Обычно терминалом по умолчанию является терминал, выбранный в качестве предпочтительного устройства в апплете "Звуки и мультимедийные свойства" панель управления.

TAPI вызывает метод AddRef в интерфейсе ITTerminal , возвращаемом ITTerminalSupport::GetDefaultStaticTerminal. Приложение должно вызвать Release в интерфейсе ITTerminal , чтобы освободить связанные с ним ресурсы.