プロパティ キー

  • [アーティクル]

プログラムによって、統合デバイス プロパティ モデル内のすべてのデバイス プロパティは、プロパティ キーによって表されます。 プロパティ キーは DEVPROPKEY 構造体としてコード化されます。 プロパティ キーは Devpkey.h で定義されています。

DEVPROPKEY 構造体には、次のメンバーがあります。

fmtid
プロパティ カテゴリを識別する DEVPROPGUID 型の変数。

pid
プロパティ識別子である DEVPROPID 型の変数。 内部システム上の理由から、プロパティ識別子は 2 以上である必要があります。

カスタム デバイス プロパティ キーを作成するには、DEFINE_DEVPROPKEY マクロを使用します。

DEFINE_DEVPROPKEY マクロを使用して DEVPROPKEY 構造体を作成する方法の例を次に示します。 構造体の名前は "DEVPROPKEYStructureName" で、0xde5c254e から 0xe0 までの値のシーケンスでGUID 値を指定し、値 "2" はプロパティ識別子です。

DEFINE_DEVPROPKEY(DEVPROPKEYStuctureName, 0xde5c254e, 0xab1c, 0xeffd, 0x80, 0x20, 0x67, 0xd1, 0x46, 0xa8, 0x50, 0xe0, 2)

注: システム定義のプロパティ キー カテゴリは、システムでのみ使用するために予約されています。