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

Статья
02/07/2025

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

Синтаксис

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

Члены

AccessFlags

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

DescriptionSize

Задает общий размер в байтах структуры KSPROPERTY_DESCRIPTION и все записи значений, следовать за ним. Если запрос на свойство базовой поддержки не возвращает записи значений, этот элемент имеет размер KSPROPERTY_DESCRIPTION.

PropTypeSet

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

MembersListCount

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

Reserved

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

Замечания

Драйвер возвращает KSPROPERTY_DESCRIPTION структуру в ответ на базовый запрос свойства поддержки от клиента.

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

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

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