Compartir a través de


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

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.

Requisitos

   
Plataforma de destino Windows
Encabezado tapi3if.h (include Tapi3.h)

Consulte también

Address (objeto)

ITTerminalSupport

Tipo de medio

TERMINAL_DIRECTION

Terminal (objeto)

Interfaces de objeto de terminal