KSPROPERTY_VALUES結構（ks.h）

2025-02-07

KSPROPERTY_VALUES 結構描述屬性的類型和可接受的預設值。

語法

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

成員

PropTypeSet

指定 KSIDENTIFIER 結構（請參閱 KSEVENT），以識別屬性的數據類型。 KSIDENTIFIER 結構的 Set 成員表示支援的實值型別集合，而相同結構 標識符 成員會識別集合內的型別。

MembersListCount

指定由 MembersList 所指向之陣列中的項目數，。

MembersList

指向 KSPROPERTY_MEMBERSLIST 結構的陣列。每個項目都會指定屬性可能假設的可能值或值集合清單。

言論

PropTypeSet.Set 幾乎一律等於 KSPROPTYPESETID_General。 KSPROPTYPESETID_General 中的個別實值型別會對應至 VARENUM 列舉型別。

串流媒體中 PropTypeSet.Id 的可能值（音訊/相機）包括：

價值	數據類型
VT_BLOB	長度前置位元組。
VT_BOOL	布爾值。 True 為 -1，false 為 0。
VT_CLSID	類別標識碼。
VT_I4	4 位元組整數。
VT_ILLEGAL	不合法的值。
VT_LPWSTR	寬的 Null 終止字串。
VT_R8	8 位元組實數。
VT_UI1	不帶正負號的字元。
VT_UI2	不帶正負號的簡短。
VT_UI4	不帶正負號的 4 位元組整數。
VT_UI8	不帶正負號的8位元組整數。