Partager via


Interface IAudioChannelConfig (devicetopology.h)

L’interface IAudioChannelConfig permet d’accéder à un contrôle de configuration de canal matériel. Le client obtient une référence à l’interface IAudioChannelConfig d’une sous-unité en appelant la méthode IPart ::Activate avec refiid de paramètre défini sur REFIID IID_IAudioChannelConfig. L’appel à IPart ::Activate réussit uniquement si la sous-unité prend en charge l’interface IAudioChannelConfig . Seul un objet de sous-unité qui représente un contrôle de configuration de canal matériel prend en charge cette interface.

Un client de l’interface IAudioChannelConfig programme un contrôle de configuration de canal matériel en écrivant un masque de configuration de canal dans le contrôle. Le masque spécifie l’affectation des canaux audio aux haut-parleurs. Pour plus d’informations sur les masques de configuration de canal, consultez KSPROPERTY_AUDIO_CHANNEL_CONFIG.

La plupart des pilotes d’adaptateur audio Windows prennent en charge le modèle de pilote Windows (WDM) et utilisent les propriétés KS (kernel-streaming) pour représenter les paramètres de contrôle matériel dans les sous-unités (appelées nœuds KS). L’interface IAudioChannelConfig fournit un accès pratique à la propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG d’une sous-unité qui a une valeur GUID de sous-type KSNODETYPE_3D_EFFECTS, KSNODETYPE_DAC, KSNODETYPE_VOLUME ou KSNODETYPE_PROLOGIC_DECODER. Pour obtenir le GUID de sous-type d’une sous-unité, appelez la méthode IPart ::GetSubType . Pour plus d’informations sur les propriétés KS et les types de nœuds KS, consultez la documentation du DDK Windows.

Héritage

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

Méthodes

L’interface IAudioChannelConfig a ces méthodes.

 
IAudioChannelConfig ::GetChannelConfig

La méthode GetChannelConfig obtient le masque de configuration de canal actuel à partir d’un contrôle de configuration de canal.
IAudioChannelConfig ::SetChannelConfig

La méthode SetChannelConfig définit le masque de configuration de canal dans un contrôle de configuration de canal.

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

Interfaces audio principales

DeviceTopology API

IPart ::Activate