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

Artículo
03/08/2023

El método GetDefaultStaticTerminal obtiene el terminal estático predeterminado para el tipo de medio especificado.

Sintaxis

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

Parámetros

[in] lMediaType

Tipo de medio del terminal necesario.

[in] Direction

TERMINAL_DIRECTION descriptor de la dirección del terminal.

[out] ppTerminal

Puntero a la interfaz ITTerminal . NULL si no hay ningún terminal disponible.

Valor devuelto

Este método puede devolver uno de estos valores.

Value	Significado
S_OK	El método se realizó correctamente.
S_FALSE	No hay terminal disponible. *ppTerminal se devolverá como NULL.
E_FAIL	Error no especificado.
E_POINTER	El parámetro lMediaType no es un puntero válido.
E_MEDIATYPE	El parámetro lMediaType no es un tipo de medio válido.
E_OUTOFMEMORY	Existe memoria insuficiente para crear el objeto Terminal.

Comentarios

Este método no devuelve terminales dinámicos. Por ejemplo, tener un tipo de medio de TAPIMEDIATYPE_VIDEO y una dirección terminal de TD_RENDER define un terminal dinámico; este método producirá un error con esos parámetros.

El terminal estático predeterminado devuelto por este método es uno de los terminales estáticos devueltos por ITTerminalSupport::EnumerateStaticTerminals o ITTerminalSupport::get_StaticTerminals. Normalmente, el terminal predeterminado es el seleccionado como "dispositivo preferido" en el applet "Sonidos y propiedades multimedia" de Panel de control.

TAPI llama al método AddRef en la interfaz ITTerminal devuelta por ITTerminalSupport::GetDefaultStaticTerminal. La aplicación debe llamar a Release en la interfaz ITTerminal para liberar recursos asociados a él.