Méthode IConnector ::GetType (devicetopology.h)
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 |
|---|---|
|
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 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 |