KSPIN_DESCRIPTOR 结构 (ks.h)

项目
03/05/2024

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 结构的数组。根据驱动程序的内部状态指示引脚类型当前支持的数据范围集。