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	Boolean 值。 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 位元整數。