KSPROPERTY_VALUES構造体 (ks.h)

[アーティクル]
02/26/2024

KSPROPERTY_VALUES構造体は、プロパティの型と許容される既定値を表します。

構文

typedef struct {
  KSIDENTIFIER                 PropTypeSet;
  ULONG                        MembersListCount;
  const KSPROPERTY_MEMBERSLIST *MembersList;
} KSPROPERTY_VALUES, *PKSPROPERTY_VALUES;

メンバー

PropTypeSet

プロパティのデータ型を識別する KSIDENTIFIER 構造体 ( KSEVENT を参照) を指定します。 KSIDENTIFIER 構造体の Set メンバーは、サポートされている値型のセットを示し、同じ構造体の Id メンバーはセット内の型を識別します。

MembersListCount

MembersList が指す配列内のエントリの数を指定します。

MembersList

KSPROPERTY_MEMBERSLIST構造体の配列を指します。各エントリは、プロパティが想定する可能性のある値または値のセットの一覧を指定します。

注釈

PropTypeSet.Set は、ほぼ常にKSPROPTYPESETID_Generalと等しくなります。 KSPROPTYPESETID_Generalの個々の値型は、VARENUM 列挙型に対応します。

ストリーミングメディア (オーディオ/カメラ) の PropTypeSet.Id に使用できる値は次のとおりです。

値	データ型
VT_BLOB	長さプレフィックス付きバイト。
VT_BOOL	ブール値です。 True は -1、false は 0 です。
VT_CLSID	クラス ID。
VT_I4	4 バイトの整数。
VT_ILLEGAL	無効な値。
VT_LPWSTR	null で終わるワイド文字列。
VT_R8	8 バイトの実数。
VT_UI1	符号なし文字。
VT_UI2	符号なし short。
VT_UI4	4 バイトの符号なし整数。
VT_UI8	8 バイトの符号なし整数。