KSPROPERTY_VALUES Struktur (ks.h)

Artikel
02/07/2025

Die KSPROPERTY_VALUES-Struktur beschreibt den Typ und die zulässigen Standardwerte einer Eigenschaft.

Syntax

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

Angehörige

PropTypeSet

Gibt eine KSIDENTIFIER- Struktur an (siehe KSEVENT-), die den Datentyp der Eigenschaft identifiziert. Das Set Member einer KSIDENTIFIER- Struktur gibt den unterstützten Satz von Werttypen an, und das ID- Element derselben Struktur identifiziert den Typ innerhalb der Gruppe.

MembersListCount

Gibt die Anzahl der Einträge im Array an, auf die durch MembersList-verwiesen wird.

MembersList

Verweist auf ein Array von KSPROPERTY_MEMBERSLIST Strukturen. Jeder Eintrag gibt eine Liste möglicher Werte oder Wertesätze an, die von der Eigenschaft angenommen werden können.

Bemerkungen

PropTypeSet.Set ist fast immer gleich KSPROPTYPESETID_General. Die einzelnen Werttypen in KSPROPTYPESETID_General entsprechen den VARENUM- Enumerationstypen.

Mögliche Werte für PropTypeSet.Id in Streamingmedien (Audio/Kamera) sind:

Wert	Datentyp
VT_BLOB	Byte mit Längenpräfix.
VT_BOOL	Ein boolescher Wert. True ist -1 und false ist 0.
VT_CLSID	Eine Klassen-ID.
VT_I4	Eine 4-Byte-Ganzzahl.
VT_ILLEGAL	Ein ungültiger Wert.
VT_LPWSTR	Eine breite null-beendete Zeichenfolge.
VT_R8	Ein 8-Byte-Real.
VT_UI1	Ein nicht signiertes Zeichen.
VT_UI2	Eine nicht signierte Kurzform.
VT_UI4	Eine nicht signierte 4-Byte-Ganzzahl.
VT_UI8	Eine nicht signierte 8-Byte-Ganzzahl.