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
一个由 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,这些 GUID 均在 Ksmedia.h中定义。 另请参阅 Pin Category 属性。
Name
指定存储在注册表中的固定类型的本地化 Unicode 字符串名称的 GUID。
Reserved
未使用。 未命名联合的成员,用于强制对未命名结构进行适当的对齐。
ConstrainedDataRangesCount
指定由 ConstrainedDataRanges指向的数组中的条目数。
ConstrainedDataRanges
指向 KSDATARANGE 结构的数组。 根据驱动程序的内部状态,指示引脚类型当前支持的一组数据范围。
言论
驱动程序通常为它们支持的每个引脚类型定义一个KSPIN_DESCRIPTOR结构。
要求
要求 | 价值 |
---|---|
标头 | ks.h (包括 Ks.h) |