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

Статья
02/07/2025

Структура KSPIN_DESCRIPTOR описывает базовые свойства KSPROPSETID_Pin типа закреплений.

Синтаксис

typedef struct {
  ULONG                 InterfacesCount;
  const KSPIN_INTERFACE *Interfaces;
  ULONG                 MediumsCount;
  const KSPIN_MEDIUM    *Mediums;
  ULONG                 DataRangesCount;
  const PKSDATARANGE    *DataRanges;
  KSPIN_DATAFLOW        DataFlow;
  KSPIN_COMMUNICATION   Communication;
  const GUID            *Category;
  const GUID            *Name;
  union {
    LONGLONG Reserved;
    struct {
      ULONG        ConstrainedDataRangesCount;
      PKSDATARANGE *ConstrainedDataRanges;
    };
  };
} KSPIN_DESCRIPTOR, *PKSPIN_DESCRIPTOR;

Члены

InterfacesCount

Указывает размер массива, на который указывает интерфейсы .

Interfaces

Массив структур KSPIN_INTERFACE, указывающих интерфейсы, поддерживаемые этим типом пин-кода.

MediumsCount

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

Mediums

Массив структур KSPIN_MEDIUM, указывающих среды, поддерживаемые этим типом пин-кода.

DataRangesCount

Указывает размер массива, на который указывает DataRanges.

DataRanges

Массив структуры KSDATARANGE, указывающие диапазоны данных, поддерживаемые этим типом пин-кода.

DataFlow

Указывает KSPIN_DATAFLOW_IN или KSPIN_DATAFLOW_OUT. См. KSPROPERTY_PIN_DATAFLOW.

Communication

Указывает KSPIN_COMMUNICATION_NONE, KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE, KSPIN_COMMUNICATION_BOTH или KSPIN_COMMUNICATION_BRIDGE. Сведения о значении каждого значения см. в KSPROPERTY_PIN_COMMUNICATION.

Category

Указывает указатель на GUID категории контактов KS. GUID категории контактов KS определяет общую категорию функциональных возможностей, которые предоставляет пин-код. Примеры идентификаторов GUID категории контактов KS: KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES и KSNODETYPE_MICROPHONE, которые определены в Ksmedia.h. См. также свойств категории пин-кода.

Name

Указывает GUID локализованного имени строки Юникода для типа пин-кода, хранящегося в реестре.

Reserved

Не используется. Член неназванного объединения, используемый для принудительного выравнивания по неименованной структуре.

ConstrainedDataRangesCount

Указывает количество записей в массиве, на которые указывает ConstrainedDataRanges.

ConstrainedDataRanges

Указывает на массив структур KSDATARANGE. Указывает набор диапазонов данных, поддерживаемых типом пин-кода, в зависимости от внутреннего состояния драйвера.