Share via

Méthode IConnector ::GetType (devicetopology.h)

  • Article

La méthode GetType obtient le type de ce connecteur.

Syntaxe

HRESULT GetType(
  [out] ConnectorType *pType
);

Paramètres

[out] pType

Pointeur vers une variable dans laquelle la méthode écrit le type de connecteur. Le type de connecteur est l’une des constantes d’énumération ConnectorType suivantes :

Unknown_Connector

Physical_Internal

Physical_External

Software_IO

Software_Fixed

Réseau

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
E_POINTER
 Le pointeur pType a la valeur NULL.

Remarques

Un connecteur correspond à une « broche » dans la terminologie de diffusion en continu du noyau (KS). Le mappage des broches KS aux connecteurs est le suivant :

  • Si le type de communication de broche KS est KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE ou KSPIN_COMMUNICATION_BOTH, le type de connecteur est Software_IO.
  • Sinon, si la broche fait partie d’une connexion physique entre deux filtres KS (périphériques) dans le même adaptateur audio ou dans des adaptateurs audio différents, le type de connecteur est Software_Fixed.
  • Sinon, si la catégorie de broche KS est KSNODETYPE_SPEAKER, KSNODETYPE_MICROPHONE, KSNODETYPE_LINE_CONNECTOR ou KSNODETYPE_SPDIF_INTERFACE, le type de connecteur est Physical_External.
  • Sinon, pour une broche qui ne répond à aucun des critères précédents, le type de connecteur est Physical_Internal.
Pour plus d’informations sur les broches KS, consultez la documentation du DDK Windows.

Pour obtenir un exemple de code qui appelle la méthode GetType , consultez l’implémentation de la fonction SelectCaptureDevice dans Topologies d’appareils.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête devicetopology.h

Voir aussi

IConnector, interface