Partager via


Accès aux propriétés de la classe d’appareil

Dans Windows Vista et les versions ultérieures de Windows, les applications et les programmes d’installation peuvent accéder aux propriétés de classe d’installation de l’appareil et aux propriétés de classe d’interface d’appareil en appelant les fonctions suivantes.

Notes

SetupApi n’est pas pris en charge sur toutes les éditions de Windows. Dans la mesure du possible, vous devez utiliser des API de couche inférieure telles que celles disponibles via CfgMgr32.dll. Pour obtenir des conseils, consultez Portage de SetupApi vers CfgMgr32 .

Pour plus d’informations sur l’accès aux propriétés de classe d’appareil sur Windows Server 2003, Windows XP et Windows 2000, consultez Accès aux propriétés de la classe d’installation de l’appareil et Accès aux propriétés de la classe d’interface d’appareil.

Récupération des propriétés

Les API de propriété telles que CM_Get_Class_Property ou SetupDiGetClassProperty peuvent être utilisées pour récupérer une propriété de classe pour une classe d’installation d’appareil ou une classe d’interface d’appareil.

Définition de propriétés

Les API de propriété telles que CM_Set_Class_Property ou SetupDiSetClassProperty peuvent être utilisées pour définir une propriété de classe pour une classe d’installation d’appareil ou une classe d’interface d’appareil.

Obtention d’une liste des propriétés disponibles

Les API de propriété telles que CM_Get_Class_Property_Keys ou SetupDiGetClassPropertyKeys peuvent être utilisées pour récupérer un tableau des clés de propriété qui identifient les propriétés actuellement définies pour une classe d’installation d’appareil ou une classe d’interface d’appareil. Cela peut être utilisé pour déterminer l’ensemble complet des propriétés définies sur une classe. Toutefois, l’utilisation de ces fonctions, en particulier pour récupérer ensuite la valeur de toutes les propriétés que ces fonctions indiquent sont définies sur la classe, doit être utilisée avec parcimonie, car la récupération de la liste de toutes les propriétés et de leurs valeurs peut être une opération coûteuse.