Création de propriétés d'appareil personnalisées

Dans Windows Vista et versions ultérieures de Windows, le modèle de propriétés unifié des périphériques prend en charge la création de catégories de propriétés de périphérique personnalisées pour les instances de périphérique, les classes d’installation de périphériques, les classes d’interface de périphérique et les interfaces de périphérique. Une propriété personnalisée est accessible en appelant la fonction property 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 AddProperty INF ou d’une directive INF DelProperty.

Pour plus d’informations sur les propriétés d’appareil personnalisées, consultez les sections suivantes :

Création de catégories de propriétés d’appareil personnalisées

Utilisation de fonctions de propriété pour accéder aux propriétés d’appareil personnalisées

Utilisation de la directive INF AddProperty ou de la directive INF DelProperty pour modifier une propriété d’appareil personnalisée

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.

  Note

  Les catégories de propriétés définies par le système sont réservées à l’usage exclusif du système d’exploitation.

• Définissez l’identifiant de chaque clé de propriété sur une valeur entière unique dans la catégorie de propriété et supérieure ou égale à deux.

Vous pouvez également créer une catégorie de propriétés d’appareil personnalisée pour une instance d’appareil à l’aide d’une directive AddProperty INF.

Utilisation de 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écrite dans Accès aux propriétés.

Utilisation de la directive INF AddProperty 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 AddProperty INF, incluez une directive AddProperty dans la section qui installe le composant et fournissez les entrées suivantes pour la propriété :

• L’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é d’appareil personnalisée

• L’entrée de valeur d’une nouvelle propriété d’appareil ou l’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 les sections Utilisation des directives INF AddProperty et INF DelProperty.