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
数据可在此流中传输的方向。 对于单向数据流,数据流 具有值 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
指向此流支持的 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。
要求
要求 | 价值 |
---|---|
标头 | strmini.h (包括 Strmini.h) |