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

一个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

指定指向 KS 引脚类别 GUID 的指针。 KS 引脚类别 GUID 标识引脚提供的功能的常规类别。 KS 引脚类别 GUID 的示例包括 KSNODETYPE_SPEAKER、KSNODETYPE_HEADPHONES 和 KSNODETYPE_MICROPHONE,它们都在 Ksmedia.h 中定义。 另请参阅 固定类别属性

Name

为注册表中存储的固定类型指定本地化 Unicode 字符串名称的 GUID。

Reserved

未使用。 未命名联合的成员,用于强制未命名结构上的正确对齐。

ConstrainedDataRangesCount

指定 ConstrainedDataRanges 指向的数组中的条目数。

ConstrainedDataRanges

指向 KSDATARANGE 结构的数组。 根据驱动程序的内部状态指示引脚类型当前支持的数据范围集。

注解

驱动程序通常为其支持的每个引脚类型定义一个KSPIN_DESCRIPTOR结构。

要求

要求
Header ks.h (包括 Ks.h)

另请参阅

KSDATARANGE

KSPIN_MEDIUM

KSPROPERTY_PIN_COMMUNICATION

KSPROPERTY_PIN_DATAFLOW

KSPROPSETID_Pin