Поделиться через


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

Структура 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.

Interfaces

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

MediumsCount

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

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 . Указывает набор диапазонов данных, поддерживаемых типом пин-кода на основе внутреннего состояния драйвера.

Комментарии

Драйверы обычно определяют одну структуру KSPIN_DESCRIPTOR для каждого поддерживаемого типа закрепления.

Требования

Требование Значение
Заголовок ks.h (включая Ks.h)

См. также раздел

KSDATARANGE

KSPIN_MEDIUM

KSPROPERTY_PIN_COMMUNICATION

KSPROPERTY_PIN_DATAFLOW

KSPROPSETID_Pin