структура HW_STREAM_INFORMATION (strmini.h)

Статья
02/07/2025

Структура 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

Указывает GUID локализованного имени строки Юникода для типа пин-кода, хранящегося в реестре.

MediumsCount

Количество записей в массиве, начинающегося с адреса в поле средних.

Mediums

Указатель на начало массива KSPIN_MEDIUM структур, поддерживаемых этим потоком. Если мини-driver не указывает средний, драйвер класса использует KSMEDIUMSETID_STANDARD, KSMEDIUM_TYPE_ANYINSTANCE средний в качестве значения по умолчанию.

BridgeStream

Если TRUE, тип связи базового типа пин-кода этого потока KSPIN_COMMUNICATION_BRIDGE. В противном случае тип связи по умолчанию потока KSPIN_COMMUNICATION_SINK.

Большинство мини-drivers установите этот элемент на FALSE. Описание типов связи см. в KSPROPERTY_PIN_COMMUNICATIONS.

Reserved[2]

Зарезервировано для использования драйвером класса. Не используйте.

Замечания

Драйвер класса использует элементы HW_STREAM_INFORMATION для обработки запросов свойств KSPROPSETID_Pin. Индекс в структуре HW_STREAM_DESCRIPTOR служит идентификатором типа пин-кода.

Обратите внимание, что драйвер класса не использует эти данные для обработки свойства KSPROPERTY_PIN_DATAINTERSECTION. Сведения о том, как драйвер класса обрабатывает это свойство, см. в STREAM_DATA_INTERSECT_INFO.

Требования

Требование	Ценность
заголовка	strmini.h (include Strmini.h)

См. также

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

Поделиться через