Metodo ITTerminalSupport::GetDefaultStaticTerminal (tapi3if.h)

Articolo
03/08/2023

Il metodo GetDefaultStaticTerminal ottiene il terminale statico predefinito per il tipo di supporto specificato.

Sintassi

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

Parametri

[in] lMediaType

Tipo di supporto del terminale richiesto.

[in] Direction

TERMINAL_DIRECTION descrittore della direzione del terminale.

[out] ppTerminal

Puntatore all'interfaccia ITTerminal . NULL se non è disponibile alcun terminale.

Valore restituito

Questo metodo può restituire uno di questi valori.

valore	Significato
S_OK	Il metodo è riuscito.
S_FALSE	Nessun terminale disponibile. *ppTerminal verrà restituito come NULL.
E_FAIL	Errore non specificato.
E_POINTER	Il parametro lMediaType non è un puntatore valido.
E_MEDIATYPE	Il parametro lMediaType non è un tipo di supporto valido.
E_OUTOFMEMORY	Memoria insufficiente per creare l'oggetto Terminal.

Commenti

Questo metodo non restituisce terminali dinamici. Ad esempio, avere un tipo di supporto di TAPIMEDIATYPE_VIDEO e una direzione del terminale di TD_RENDER definisce un terminale dinamico; questo metodo avrà esito negativo con tali parametri.

Il terminale statico predefinito restituito da questo metodo è uno dei terminali statici restituiti da ITTerminalSupport::EnumerateStaticTerminals o ITTerminalSupport::get_StaticTerminals. In genere, il terminale predefinito è quello selezionato come "dispositivo preferito" nell'applet "Suoni e proprietà multimediali" di Pannello di controllo.

TAPI chiama il metodo AddRef sull'interfaccia ITTerminal restituita da ITTerminalSupport::GetDefaultStaticTerminal. L'applicazione deve chiamare Release nell'interfaccia ITTerminal per liberare le risorse associate.