カスタム デバイス プロパティの作成
Windows Vista 以降のバージョンの Windows では、統合デバイス プロパティ モデルは、デバイス インスタンス、デバイス セットアップ クラス、デバイス インターフェイス クラス、およびデバイス インターフェイスについて、カスタム デバイス プロパティ カテゴリの作成をサポートしています。 カスタム プロパティには、適切な プロパティ関数を呼び出すことによってアクセスできます。 カスタム デバイス プロパティは、ドライバー パッケージから、INF AddProperty ディレクティブ または INF DelProperty ディレクティブを使用して変更することもできます。
カスタム デバイス プロパティの詳細については、以下のセクションを参照してください。
プロパティ関数を使用してカスタム デバイス プロパティにアクセスする
INF AddProperty ディレクティブまたは INF DelProperty ディレクティブを使用してカスタム デバイス プロパティを変更する
カスタム デバイス プロパティ カテゴリの作成
カスタム デバイス プロパティ カテゴリは、カスタム デバイス プロパティの論理的に関連するコレクションです。 カスタム デバイス プロパティ カテゴリをプログラムで作成するには、DEFINE_DEVPROPKEY マクロを使用して、プロパティ カテゴリ内のプロパティを表すプロパティ キーを次のように作成します。
プロパティ カテゴリを表す一意の GUID 値を作成し、各プロパティ キーの GUID 値をこの一意の GUID 値に設定します。 新しい GUID 値を作成する方法については、「新しい GUID の定義とエクスポート」を参照してください。
Note
システム定義のプロパティ カテゴリは、オペレーティング システム専用に予約されています。
各プロパティ キーのプロパティ識別子を、プロパティ カテゴリ内で一意であり、2 以上の整数値に設定します。
INF AddProperty ディレクティブを使用することによって、デバイス インスタンス用のカスタム デバイス プロパティ カテゴリを作成することもできます。
プロパティ関数を使用してカスタム デバイス プロパティにアクセスする
「プロパティへのアクセス」で説明されているのと同じ方法で、カスタム デバイス プロパティにアクセスします。
INF AddProperty ディレクティブまたは INF DelProperty ディレクティブを使用してカスタム デバイス プロパティを変更する
INF AddProperty ディレクティブを使用してカスタム デバイス プロパティを変更するには、コンポーネントをインストールするセクションに AddProperty ディレクティブを含めて、プロパティに対して次のエントリを指定します。
カスタム デバイス プロパティ カテゴリを表す property-category-guid エントリ
カスタム デバイス プロパティ カテゴリ内のプロパティを識別するプロパティ識別子エントリ
新しいデバイス プロパティの value エントリ、または既存のデバイス プロパティ値を変更する value エントリ
INF DelProperty ディレクティブを使用して、カスタム デバイス プロパティを削除します。
これらのディレクティブの使用方法の詳細については、「INF AddProperty ディレクティブと INF DelProperty ディレクティブの使用」を参照してください。