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)

另请参阅

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER