KSPROPERTY_DESCRIPTION-Struktur (ks.h)

Artikel
02/26/2024

Die KSPROPERTY_DESCRIPTION-Struktur gibt die Größe und den Typ der Werte an, die in einer bestimmten Eigenschaft enthalten sind.

Syntax

typedef struct {
  ULONG        AccessFlags;
  ULONG        DescriptionSize;
  KSIDENTIFIER PropTypeSet;
  ULONG        MembersListCount;
  ULONG        Reserved;
} KSPROPERTY_DESCRIPTION, *PKSPROPERTY_DESCRIPTION;

Member

AccessFlags

Gibt den zulässigen Zugriff auf diese Eigenschaft an. Eine Basic-Support-Anforderung legt diesen Member auf das bitweise OR der Flags für alle Zugriffstypen fest, die der Handler für diese Eigenschaft unterstützt. Eine Liste der möglichen Flagwerte finden Sie unter KSPROPERTY.

DescriptionSize

Gibt die Gesamtgröße der KSPROPERTY_DESCRIPTION-Struktur und alle darauf folgenden Werteeinträge in Byte an. Wenn die Basic-Support-Eigenschaftsanforderung keine Werteinträge zurückgibt, ist dieser Member die Größe von KSPROPERTY_DESCRIPTION.

PropTypeSet

Eine Struktur vom Typ KSIDENTIFIER. Gibt den Typ der in dieser Eigenschaft enthaltenen Werte an, wenn dies von der jeweiligen Eigenschaft unterstützt wird. Diese Gruppe wird durch eine GUID eindeutig angegeben, sodass neue Wertetypen erstellt werden können, ohne sich mit Erweiterungen dieses Satzes zu überschneiden. Die Werttypen geben den Typ des Werts an (wie VT_BOOL, VT_UI4 im Standardsatz). Dies ist GUID_NULL, mit dem Bezeichner null, wenn Werteinformationen von dieser Eigenschaft nicht unterstützt werden.

MembersListCount

Gibt die Anzahl der KSPROPERTY_MEMBERSHEADER Strukturen an, die diesem Header folgen sollen.

Reserved

Für die zukünftige Verwendung reserviert. Auf NULL festlegen.

Hinweise

Ein Treiber gibt die KSPROPERTY_DESCRIPTION-Struktur als Antwort auf eine grundlegende Supporteigenschaftsanforderung von einem Client zurück.

Der Typ der Eigenschaftswerte wird durch eine KSIDENTIFIER-Struktur angegeben. Der unterstützte Basissatz ist KSPROPSETID_General. Die Bezeichner in diesem Satz sind die standardmäßigen VARENUM-Typen, die für OLE verwendet werden.

Die Werteinformationen, die der KSPROPERTY_DESCRIPTION-Struktur folgen können, werden durch eine Liste von KSPROPERTY_MEMBERSLIST-Strukturen beschrieben, die jeweils Datenbereichsinformationen enthalten.

Weitere Informationen finden Sie unter KS-Eigenschaften.