KSPROPERTY_MEMBERSHEADER-Struktur (ks.h)

Artikel
02/26/2024

Ein Treiber stellt eine Struktur vom Typ KSPROPERTY_MEMBERSHEADER bereit, um die Größe und den Typ jedes Elements in einem Array zu beschreiben, das Eigenschaftswerte oder -bereiche enthält.

Syntax

typedef struct {
  ULONG MembersFlags;
  ULONG MembersSize;
  ULONG MembersCount;
  ULONG Flags;
} KSPROPERTY_MEMBERSHEADER, *PKSPROPERTY_MEMBERSHEADER;

Member

MembersFlags

Gibt den Typ der Einträge in der Memberliste an. Die Größe gültiger Werte wird durch den Werttyp bestimmt, wie im PropTypeSet-Member der KSPROPERTY_DESCRIPTION-Struktur angegeben. Die Anzahl der Bereichspaare wird durch MembersCount bestimmt. Dies sollte einer der Werte sein, die in der folgenden Tabelle aufgeführt sind.

Wert	BESCHREIBUNG
KSPROPERTY_MEMBER_RANGES	Gibt an, dass Listenmember Bereiche vom Typ KSPROPERTY_BOUNDS_LONG oder KSPROPERTY_BOUNDS_LONGLONG sind.
KSPROPERTY_MEMBER_STEPPEDRANGES	Gibt an, dass die folgenden Member abgestufte Werte innerhalb von Bereichen vom Typ KSPROPERTY_STEPPING_LONG oder KSPROPERTY_STEPPING_LONGLONG sind.
KSPROPERTY_MEMBER_VALUES	Jeder Eintrag im Memberarray ist ein einzelner Wert.

MembersSize

Gibt die Größe eines einzelnen Arrayelements in Bytes an.

MembersCount

Gibt die Anzahl der Einträge im Memberarray an.

Flags

Wert	BESCHREIBUNG
KSPROPERTY_MEMBER_RANGES	Gibt an, dass Listenmember Bereiche vom Typ KSPROPERTY_BOUNDS_LONG oder KSPROPERTY_BOUNDS_LONGLONG sind.
KSPROPERTY_MEMBER_STEPPEDRANGES	Gibt an, dass die folgenden Member abgestufte Werte innerhalb von Bereichen vom Typ KSPROPERTY_STEPPING_LONG oder KSPROPERTY_STEPPING_LONGLONG sind.
KSPROPERTY_MEMBER_VALUES	Jeder Eintrag im Memberarray ist ein einzelner Wert.

Hinweise

Die Größe des Arrays kann durch Multiplizieren von MembersCount mit MembersSize bestimmt werden.

Eine KSPROPERTY_MEMBERSLIST-Struktur enthält eine KSPROPERTY_MEMBERSHEADER-Struktur als erstes Element. Das zweite Element, Member, zeigt auf ein Array von Eigenschaftswerten oder -bereichen.

Außerdem kann auf eine KSPROPERTY_DESCRIPTION Struktur eine Liste mit KSPROPERTY_MEMBERSHEADER Strukturen folgen.

Weitere Informationen zu KSPROPERTY_MEMBER_FLAG_DEFAULT finden Sie unter KSPROPERTY_ITEM. Weitere Informationen zu KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_MULTICHANNEL und KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_UNIFORM finden Sie unter Verfügbarmachen von Mehrkanalknoten in der WdK-Audiodokumentation (Windows Driver Kit).