Compartilhar via


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

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.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)

Confira também

Objeto Address

ITTerminalSupport

Típo de mídia

TERMINAL_DIRECTION

Objeto Terminal

Interfaces de objeto de terminal