ITTerminalSupport::GetDefaultStaticTerminal, méthode (tapi3if.h)

Article
08/26/2023

La méthode GetDefaultStaticTerminal obtient le terminal statique par défaut pour le type de média spécifié.

Syntaxe

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

Paramètres

[in] lMediaType

Type de média du terminal requis.

[in] Direction

TERMINAL_DIRECTION descripteur de la direction du terminal.

[out] ppTerminal

Pointeur vers l’interface ITTerminal . NULL si aucun terminal n’est disponible.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
S_FALSE	Aucun terminal n’est disponible. *ppTerminal est retourné sous la forme NULL.
E_FAIL	Erreur non spécifiée.
E_POINTER	Le paramètre lMediaType n’est pas un pointeur valide.
E_MEDIATYPE	Le paramètre lMediaType n’est pas un type de média valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour créer l’objet Terminal.

Remarques

Cette méthode ne retourne pas de terminaux dynamiques. Par exemple, avoir un type multimédia de TAPIMEDIATYPE_VIDEO et une direction terminale de TD_RENDER définit un terminal dynamique ; cette méthode échoue avec ces paramètres.

Le terminal statique par défaut retourné par cette méthode est l’un des terminaux statiques retournés par ITTerminalSupport::EnumerateStaticTerminals ou ITTerminalSupport::get_StaticTerminals. En règle générale, le terminal par défaut est celui sélectionné comme « appareil préféré » dans l’applet « Sons et propriétés multimédias » de Panneau de configuration.

TAPI appelle la méthode AddRef sur l’interface ITTerminal retournée par ITTerminalSupport::GetDefaultStaticTerminal. L’application doit appeler Release sur l’interface ITTerminal pour libérer les ressources qui lui sont associées.