Erstellen von benutzerdefinierten Geräteeigenschaften

In Windows Vista und höheren Versionen von Windows unterstützt das einheitliche Geräteeigenschaftenmodell die Erstellung benutzerdefinierter Geräteeigenschaftenkategorien für Geräteinstanzen, Geräteeinrichtungsklassen, Geräteschnittstellenklassen und Geräteschnittstellen. Auf eine benutzerdefinierte Eigenschaft kann durch Aufrufen der entsprechenden Eigenschaftsfunktion zugegriffen werden. Eine benutzerdefinierte Geräteeigenschaft kann auch über ein Treiberpaket mithilfe einer INF-AddProperty-Direktive oder einer INF DelProperty-Direktive geändert werden.

Weitere Informationen zu benutzerdefinierten Geräteeigenschaften finden Sie in den folgenden Abschnitten:

Erstellen benutzerdefinierter Geräteeigenschaftenkategorien

Verwenden von Eigenschaftenfunktionen für den Zugriff auf benutzerdefinierte Geräteeigenschaften

Verwenden der INF-AddProperty-Direktive oder der INF DelProperty-Direktive zum Ändern einer benutzerdefinierten Geräteeigenschaft

Erstellen benutzerdefinierter Geräteeigenschaftenkategorien

Eine benutzerdefinierte Geräteeigenschaftskategorie ist eine logisch bezogene Sammlung von benutzerdefinierten Geräteeigenschaften. Verwenden Sie zum programmgesteuerten Erstellen einer benutzerdefinierten Geräteeigenschaftskategorie das makro DEFINE_DEVPROPKEY , um die Eigenschaftenschlüssel zu erstellen, die die Eigenschaften in der Eigenschaftskategorie darstellen, wie folgt:

  • Erstellen Sie einen eindeutigen GUID-Wert, der die Eigenschaftskategorie darstellt, und legen Sie den GUID-Wert jedes Eigenschaftsschlüssels auf diesen eindeutigen GUID-Wert fest. Informationen zum Erstellen eines neuen GUID-Werts finden Sie unter Definieren und Exportieren neuer GUIDs.

    Note

    Die vom System definierten Eigenschaftenkategorien sind nur für die Verwendung des Betriebssystems reserviert.

  • Legen Sie den Eigenschaftenbezeichner jedes Eigenschaftsschlüssels auf einen ganzzahligen Wert fest, der innerhalb der Eigenschaftskategorie eindeutig ist und größer als oder gleich zwei ist.

Sie können auch eine benutzerdefinierte Geräteeigenschaftskategorie für eine Geräteinstanz erstellen, indem Sie eine INF-AddProperty-Direktive verwenden.

Verwenden von Eigenschaftenfunktionen für den Zugriff auf benutzerdefinierte Geräteeigenschaften

Greifen Sie auf benutzerdefinierte Geräteeigenschaften auf die gleiche Weise zu, wie unter Accessing Properties) beschrieben.

Verwenden der INF-AddProperty-Direktive oder der INF DelProperty-Direktive zum Ändern einer benutzerdefinierten Geräteeigenschaft

Um eine benutzerdefinierte Geräteeigenschaft mithilfe einer INF-AddProperty-Direktive zu ändern, fügen Sie eine AddProperty-Direktive in den Abschnitt ein, in dem die Komponente installiert wird, und geben Sie die folgenden Einträge für die Eigenschaft an:

  • Der Eintrag property-category-guid, der die Kategorie benutzerdefinierter Geräteeigenschaften darstellt.

  • Ein Eintrag für einen Eigenschaftsbezeichner, der die Eigenschaft innerhalb der Kategorie der benutzerdefinierten Geräteeigenschaften identifiziert

  • Der Eintrag value einer neuen Geräteeigenschaft oder der Eintrag value, der einen vorhandenen Geräteeigenschaftswert ändert

Verwenden Sie die INF DelProperty-Direktive , um eine benutzerdefinierte Geräteeigenschaft zu löschen.

Weitere Informationen zur Verwendung dieser Direktiven finden Sie unter Verwenden der INF-AddProperty-Direktive und der INF-DelProperty-Direktive.