Partager via


Interface IDeviceSpecificProperty (devicetopology.h)

L’interface IDeviceSpecificProperty permet d’accéder à la valeur de contrôle d’un contrôle matériel spécifique à l’appareil. Un client obtient une référence à une interface IDeviceSpecificProperty d’une partie en appelant la méthode IPart::Activate avec refiid de paramètre défini sur REFIID IID_IDeviceSpecificProperty. L’appel à IPart::Activate réussit uniquement si le composant prend en charge l’interface IDeviceSpecificProperty . Une partie prend en charge cette interface uniquement si le contrôle matériel sous-jacent a une valeur de contrôle spécifique à l’appareil et si le contrôle ne peut pas être représenté de manière adéquate par une autre interface dans l’API DeviceTopology.

En règle générale, une propriété spécifique à l’appareil n’est utile qu’à un client qui peut déduire la signification de la valeur de la propriété à partir d’informations telles que le type de composant, le sous-type de partie et le nom de la partie. Le client peut obtenir ces informations en appelant les méthodes IPart::GetPartType, IPart::GetSubType et IPart::GetName .

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 contrôle matériel dans les sous-unités (appelées nœuds KS). L’interface IDeviceSpecificProperty fournit un accès pratique à la propriété KSPROPERTY_AUDIO_DEV_SPECIFIC d’une sous-unité qui a une valeur GUID de sous-type de KSNODETYPE_DEV_SPECIFIC. 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 windows DDK.

Héritage

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

Méthodes

L’interface IDeviceSpecificProperty a ces méthodes.

 
IDeviceSpecificProperty::Get4BRange

La méthode Get4BRange obtient la plage de 4 octets de la valeur de propriété spécifique à l’appareil.
IDeviceSpecificProperty::GetType

La méthode GetType obtient le type de données de la valeur de propriété spécifique à l’appareil.
IDeviceSpecificProperty::GetValue

La méthode GetValue obtient la valeur actuelle de la propriété spécifique à l’appareil.
IDeviceSpecificProperty::SetValue

La méthode SetValue définit la valeur de la propriété spécifique à l’appareil.

Spécifications

   
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

IPart::GetName

IPart::GetPartType

IPart::GetSubType