共用方式為


建立自定義裝置屬性

在 Windows Vista 和更新版本的 Windows 中, 統一裝置屬性模型 支援建立裝置實例、 裝置設定類別裝置介面類別和裝置介面的自定義裝置屬性類別。 您可以呼叫適當的 屬性函式來存取自訂屬性。 您也可以使用 INF AddProperty 指示詞或 INF DelProperty 指示詞,從驅動程式套件修改自定義裝置屬性。

如需自定義裝置屬性的詳細資訊,請參閱下列各節:

建立自定義裝置屬性類別

使用屬性函式存取自定義裝置屬性

使用 INF AddProperty 指示詞或 INF DelProperty 指示詞修改自定義裝置屬性

建立自定義裝置屬性類別

自訂裝置屬性類別是自定義裝置屬性的邏輯相關集合。 若要以程式設計方式建立自定義裝置屬性類別目錄,請使用 DEFINE_DEVPROPKEY 巨集來建立屬性索引鍵,以代表屬性類別中的屬性,如下所示:

  • 建立代表屬性類別的唯一 GUID 值,並將每個屬性索引鍵的 GUID 值設定為這個唯一 GUID 值。 如需如何建立新 GUID 值的資訊,請參閱 定義和匯出新的 GUID

    備註

    系統定義的屬性類別只會保留給作系統使用。

  • 將每個屬性索引鍵的屬性標識碼設定為屬性類別目錄內唯一且大於或等於兩個的整數值。

您也可以使用 INF AddProperty 指示詞,為裝置實例建立自定義裝置屬性類別目錄。

使用屬性函式存取自定義裝置屬性

以與 存取屬性中所述的相同方式存取自定義裝置屬性。

使用 INF AddProperty 指示詞或 INF DelProperty 指示詞修改自定義裝置屬性

若要使用 INF AddProperty 指示詞修改自定義裝置屬性,請在安裝元件的區段中加入 AddProperty 指示詞,並提供以下屬性項目以便進行修改:

  • 代表自定義裝置屬性類別的 property-category-guid 條目

  • 識別在自定義裝置屬性類別中屬性的識別項目

  • 新裝置屬性值項目或修改現有裝置屬性值的項目

使用 INF DelProperty 指示詞 來刪除自訂裝置屬性。

如需如何使用這些指示詞的詳細資訊,請參閱 使用 INF AddProperty 指示詞和 INF DelProperty 指示詞