Interface IKsJackDescription2 (devicetopology.h)

L’interface IKsJackDescription2 fournit des informations sur les prises jack ou les connecteurs internes qui fournissent une connexion physique entre un appareil sur une carte audio et un périphérique de point de terminaison externe ou interne (par exemple, un microphone ou un lecteur CD).

En plus d’obtenir des informations jack telles que le type de connexion, le IKsJackDescription est principalement utilisé pour indiquer si la prise a été connectée à l’appareil. Dans Windows 7, si le pilote de périphérique connecté prend en charge IKsJackDescription2, la pile audio ou une application peut utiliser cette interface pour obtenir des informations supplémentaires sur la prise jack. Cela inclut la capacité de détection de la prise jack et si le format de l’appareil a changé dynamiquement.

La plupart des pilotes d’adaptateur audio Windows prennent en charge le modèle de pilote Windows (WDM) et utilisent les propriétés de diffusion en continu du noyau (KS) pour représenter les paramètres de description matérielle dans les connecteurs (appelés broches KS). L’interface IKsJackDescription2 fournit un accès pratique à la propriété KSPROPERTY_JACK_DESCRIPTION2 d’un connecteur à un appareil de point de terminaison. Pour plus d’informations sur les propriétés KS et les broches KS, consultez la documentation windows DDK.

Une application obtient une référence à l’interface IKsJackDescription2 d’un composant en appelant la méthode IPart::Activate avec refiid de paramètre défini sur REFIIDIID_IKsJackDescription2. L’appel à IPart::Activate réussit uniquement si le composant prend en charge l’interface IKsJackDescription2 . Seul un objet de partie qui représente un connecteur de broche de pont sur un objet de topologie d’appareil de filtre KS prend en charge cette interface.

Pour obtenir un exemple de code, consultez IKsJackDescription.

Héritage

L’interface IKsJackDescription2 hérite de l’interface IUnknown. IKsJackDescription2 a également les types de membres suivants :

Méthodes

L’interface IKsJackDescription2 possède ces méthodes.

IKsJackDescription2::GetJackCount La méthode GetJackCount obtient le nombre de prises sur le connecteur, qui sont nécessaires pour se connecter à un appareil de point de terminaison.
IKsJackDescription2::GetJackDescription2 La méthode GetJackDescription2 obtient la description d’une prise audio spécifiée.

Spécifications

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

Voir aussi

Interfaces audio principales

DeviceTopology API

IPart::Activate