Erstellen benutzerdefinierter Geräteeigenschaften

In Windows Vista und höheren Versionen von Windows unterstützt das einheitliche Geräteeigenschaftenmodell die Erstellung von benutzerdefinierten 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 aus einem 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äteeigenschaftenkategorie ist eine logisch bezogene Sammlung benutzerdefinierter Geräteeigenschaften. Verwenden Sie zum programmgesteuerten Erstellen einer benutzerdefinierten Geräteeigenschaftenkategorie das Makro DEFINE_DEVPROPKEY , um die Eigenschaftenschlüssel zu erstellen, die die Eigenschaften in der Eigenschaftenkategorie darstellen, wie folgt:

• Erstellen Sie einen eindeutigen GUID-Wert, der die Eigenschaftenkategorie 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.

  Hinweis

  Die systemdefinierte Eigenschaftenkategorien sind nur für die Verwendung des Betriebssystems reserviert.

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

Sie können auch eine benutzerdefinierte Geräteeigenschaftenkategorie für ein Gerät instance erstellen, indem Sie eine INF-AddProperty-Direktive verwenden.

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

Zugreifen auf benutzerdefinierte Geräteeigenschaften auf die gleiche Weise wie unter Zugreifen auf Eigenschaften) 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 benutzerdefinierte Geräteeigenschaftskategorie darstellt.

• Ein Eigenschaftsbezeichnereintrag, der die Eigenschaft in der benutzerdefinierten Geräteeigenschaftskategorie identifiziert

• Der Werteintrag einer neuen Geräteeigenschaft oder der Werteintrag , 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.