Création de propriétés d’appareil personnalisées
Dans Windows Vista et les versions ultérieures de Windows, le modèle de propriété d’appareil unifié prend en charge la création de catégories de propriétés d’appareil personnalisées pour les instances d’appareil, les classes d’installation des appareils, les classesd’interface d’appareil et les interfaces d’appareil. Une propriété personnalisée est accessible en appelant la fonction de propriété appropriée. Une propriété d’appareil personnalisée peut également être modifiée à partir d’un package de pilotes à l’aide d’une directive INF AddProperty ou d’une directive INF DelProperty.
Pour plus d’informations sur les propriétés personnalisées des appareils, consultez les sections suivantes :
Création de catégories de propriétés d’appareil personnalisées
Utilisation des fonctions de propriété pour accéder aux propriétés d’appareil personnalisées
Création de catégories de propriétés d’appareil personnalisées
Une catégorie de propriétés d’appareil personnalisée est une collection logique de propriétés d’appareil personnalisées. Pour créer par programmation une catégorie de propriétés d’appareil personnalisée, utilisez la macro DEFINE_DEVPROPKEY pour créer les clés de propriété qui représentent les propriétés de la catégorie de propriétés, comme suit :
Créez une valeur GUID unique qui représente la catégorie de propriété et définissez la valeur GUID de chaque clé de propriété sur cette valeur GUID unique. Pour plus d’informations sur la création d’une valeur GUID, consultez Définition et exportation de nouveaux GUID.
Notes
Les catégories de propriétés définies par le système sont réservées à l’utilisation du système d’exploitation uniquement.
Définissez l’identificateur de propriété de chaque clé de propriété sur une valeur entière unique au sein de la catégorie de propriété et supérieure ou égale à deux.
Vous pouvez également créer une catégorie de propriété d’appareil personnalisée pour un instance d’appareil à l’aide d’une directive AddProperty INF.
Utilisation des fonctions de propriété pour accéder aux propriétés d’appareil personnalisées
Accédez aux propriétés d’appareil personnalisées de la même manière que décrit dans Accès aux propriétés) .
Utilisation de la directive AddProperty INF ou de la directive INF DelProperty pour modifier une propriété d’appareil personnalisée
Pour modifier une propriété d’appareil personnalisée à l’aide d’une directive Inf AddProperty, incluez une directive AddProperty dans la section qui installe le composant et fournissez les entrées suivantes pour la propriété :
Entrée property-category-guid qui représente la catégorie de propriété d’appareil personnalisée
Entrée d’identificateur de propriété qui identifie la propriété dans la catégorie de propriétés d’appareil personnalisée
Entrée de valeur d’une nouvelle propriété d’appareil ou entrée de valeur qui modifie une valeur de propriété d’appareil existante
Utilisez la directive INF DelProperty pour supprimer une propriété d’appareil personnalisée.
Pour plus d’informations sur l’utilisation de ces directives, consultez La directive AddProperty INF et la directive Inf DelProperty.