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)

另请参阅

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER