Método ITTerminalSupport::GetDefaultStaticTerminal (tapi3if.h)

Artigo
03/08/2023

O método GetDefaultStaticTerminal obtém o terminal estático padrão para o tipo de mídia especificado.

Sintaxe

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

Parâmetros

[in] lMediaType

Tipo de mídia do terminal necessário.

[in] Direction

TERMINAL_DIRECTION descritor da direção do terminal.

[out] ppTerminal

Ponteiro para a interface ITTerminal . NULL se nenhum terminal estiver disponível.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
S_FALSE	Nenhum terminal está disponível. *ppTerminal será retornado como NULL.
E_FAIL	Erro não especificado.
E_POINTER	O parâmetro lMediaType não é um ponteiro válido.
E_MEDIATYPE	O parâmetro lMediaType não é um tipo de mídia válido.
E_OUTOFMEMORY	Há memória insuficiente para criar o objeto Terminal.

Comentários

Esse método não retorna terminais dinâmicos. Por exemplo, ter um tipo de mídia de TAPIMEDIATYPE_VIDEO e uma direção terminal de TD_RENDER define um terminal dinâmico; esse método falhará com esses parâmetros.

O terminal estático padrão retornado por esse método é um dos terminais estáticos retornados por ITTerminalSupport::EnumerateStaticTerminals ou ITTerminalSupport::get_StaticTerminals. Normalmente, o terminal padrão é o selecionado como "dispositivo preferencial" no applet "Propriedades de Sons e Multimídia" do Painel de Controle.

O TAPI chama o método AddRef na interface ITTerminal retornada por ITTerminalSupport::GetDefaultStaticTerminal. O aplicativo deve chamar Release na interface ITTerminal para liberar recursos associados a ele.