HW_STREAM_INFORMATION 结构 (strmini.h)
HW_STREAM_INFORMATION 结构描述单个流支持的内核流语义,作为 HW_STREAM_DESCRIPTOR 结构的一部分。
语法
typedef struct _HW_STREAM_INFORMATION {
ULONG NumberOfPossibleInstances;
KSPIN_DATAFLOW DataFlow;
BOOLEAN DataAccessible;
ULONG NumberOfFormatArrayEntries;
PKSDATAFORMAT *StreamFormatsArray;
PVOID ClassReserved[4];
ULONG NumStreamPropArrayEntries;
PKSPROPERTY_SET StreamPropertiesArray;
ULONG NumStreamEventArrayEntries;
PKSEVENT_SET StreamEventsArray;
GUID *Category;
GUID *Name;
ULONG MediumsCount;
const KSPIN_MEDIUM *Mediums;
BOOLEAN BridgeStream;
ULONG Reserved[2];
} HW_STREAM_INFORMATION, *PHW_STREAM_INFORMATION;
成员
NumberOfPossibleInstances
指定可打开的此流的可能实例数。
DataFlow
数据可在此流中移动的方向。 对于单向数据流, DataFlow 的值 KSPIN_DATAFLOW_IN 或KSPIN_DATAFLOW_OUT。
DataAccessible
如果类驱动程序可以访问流数据,则指定 TRUE 。
NumberOfFormatArrayEntries
数组中从 StreamFormatsArray 成员中的地址开始的条目数。
StreamFormatsArray
指向此流支持的数据范围数组开头的指针。 (此成员的名称具有欺骗性。此成员指向 KSDATARANGE 结构的数组,而不是 KSDATAFORMAT 结构。)
ClassReserved[4]
保留供类驱动程序使用。 请勿使用。
NumStreamPropArrayEntries
数组中从 StreamPropertiesArray 成员中的地址开始的条目数。
StreamPropertiesArray
指向此流支持的属性集数组开头的指针。
NumStreamEventArrayEntries
数组中从 StreamEventsArray 字段中的地址开始的条目数。
StreamEventsArray
指向此流支持的事件集数组开头的指针。
Category
指定引脚类别的 GUID。
Name
为注册表中存储的固定类型指定本地化 Unicode 字符串名称的 GUID。
MediumsCount
数组中从 “Mediums ”字段中的地址开始的条目数。
Mediums
指向此流支持的 KSPIN_MEDIUM 结构数组开头的指针。 如果微型驱动程序未指定介质,则类驱动程序使用KSMEDIUMSETID_STANDARD,KSMEDIUM_TYPE_ANYINSTANCE介质作为默认值。
BridgeStream
如果 为 TRUE,则此流的基础引脚类型的通信类型KSPIN_COMMUNICATION_BRIDGE。 否则,流的默认通信类型为KSPIN_COMMUNICATION_SINK。
大多数微型驱动程序会将此成员设置为 FALSE。 有关通信类型的说明,请参阅KSPROPERTY_PIN_COMMUNICATIONS。
Reserved[2]
保留供类驱动程序使用。 请勿使用。
注解
类驱动程序使用 HW_STREAM_INFORMATION 的元素来处理 KSPROPSETID_Pin 属性请求。 HW_STREAM_DESCRIPTOR 结构中的索引充当引脚类型 ID 号。
请注意,类驱动程序不使用此数据来处理 KSPROPERTY_PIN_DATAINTERSECTION 属性。 有关类驱动程序如何处理此属性的说明,请参阅 STREAM_DATA_INTERSECT_INFO 。
要求
要求 | 值 |
---|---|
Header | strmini.h (包括 Strmini.h) |