структура KSPROPERTY_DESCRIPTION (ks.h)

Статья
02/26/2024

Структура KSPROPERTY_DESCRIPTION определяет размер и тип значений, содержащихся в определенном свойстве.

Синтаксис

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

Члены

AccessFlags

Указывает разрешенный доступ к этому свойству. Запрос на базовую поддержку задает для этого элемента побитовое ИЛИ флагов для всех типов доступа, поддерживаемых обработчиком для этого свойства. Список возможных значений флагов см. в разделе KSPROPERTY.

DescriptionSize

Указывает общий размер структуры KSPROPERTY_DESCRIPTION в байтах и всех последующих за ней записей значений. Если запрос на свойство basic-support не возвращает значения записей, этот элемент имеет размер KSPROPERTY_DESCRIPTION.

PropTypeSet

Структура типа KSIDENTIFIER. Если поддерживается определенным свойством, указывает тип значений, содержащихся в этом свойстве. Эта группа определяется уникальным идентификатором GUID, что позволяет создавать новые типы значений без перекрытия с расширениями этого набора. Типы значений указывают тип значения (например, VT_BOOL, VT_UI4 в стандартном наборе). Это GUID_NULL с идентификатором, равным нулю, если сведения о значениях не поддерживаются этим свойством.

MembersListCount

Указывает количество KSPROPERTY_MEMBERSHEADER структур, следующих за этим заголовком.

Reserved

Зарезервировано для последующего использования. Задайте нулевое значение.

Набор типов значений свойств определяется структурой KSIDENTIFIER . Базовый набор поддерживается KSPROPSETID_General. Идентификаторы в этом наборе являются стандартными типами VARENUM, используемыми для OLE.

Сведения о значениях, которые могут соответствовать KSPROPERTY_DESCRIPTION структуре, описываются списком KSPROPERTY_MEMBERSLIST структур, каждая из которых содержит сведения о диапазоне данных.

Дополнительные сведения см. в разделе Свойства KS.