estructura de HW_STREAM_INFORMATION (strmini.h)

La estructura de HW_STREAM_INFORMATION describe la semántica de streaming del kernel admitida por secuencias individuales, como parte de una estructura de HW_STREAM_DESCRIPTOR .

Sintaxis

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;

Miembros

NumberOfPossibleInstances

Especifica el número de instancias posibles de esta secuencia que se pueden abrir.

DataFlow

Dirección en la que los datos pueden viajar en esta secuencia. Para el flujo de datos unidireccional, DataFlow tiene el valor KSPIN_DATAFLOW_IN o KSPIN_DATAFLOW_OUT.

DataAccessible

Especifica TRUE si los datos del flujo son accesibles para el controlador de clase.

NumberOfFormatArrayEntries

Número de entradas de la matriz que comienza en la dirección del miembro StreamFormatsArray .

StreamFormatsArray

Puntero al principio de la matriz de intervalos de datos que admite esta secuencia. (El nombre de este miembro es engañoso. Este miembro apunta a una matriz de estructuras KSDATARANGE , no a estructuras KSDATAFORMAT).

ClassReserved[4]

Reservado para su uso por el controlador de clase. No debe usarse.

NumStreamPropArrayEntries

Número de entradas de la matriz que comienza en la dirección del miembro StreamPropertiesArray .

StreamPropertiesArray

Puntero al principio de la matriz de conjuntos de propiedades admitidos por esta secuencia.

NumStreamEventArrayEntries

Número de entradas de la matriz que comienza en la dirección del campo StreamEventsArray .

StreamEventsArray

Puntero al principio de la matriz de conjuntos de eventos admitidos por esta secuencia.

Category

Especifica el GUID de la categoría de patillas.

Name

Especifica el GUID del nombre de cadena Unicode localizado para el tipo de patilla, almacenado en el Registro.

MediumsCount

Número de entradas de la matriz que comienza en la dirección del campo Medios .

Mediums

Puntero al principio de la matriz de estructuras de KSPIN_MEDIUM compatibles con esta secuencia. Si el minidriver no especifica un medio, el controlador de clase usa el KSMEDIUMSETID_STANDARD, KSMEDIUM_TYPE_ANYINSTANCE medio como predeterminado.

BridgeStream

Si es TRUE, el tipo de comunicación del tipo de patilla subyacente de esta secuencia es KSPIN_COMMUNICATION_BRIDGE. De lo contrario, el tipo de comunicaciones predeterminado de una secuencia es KSPIN_COMMUNICATION_SINK.

La mayoría de los minidrivers establecerán este miembro en FALSE. Consulte KSPROPERTY_PIN_COMMUNICATIONS para obtener una descripción de los tipos de comunicación.

Reserved[2]

Reservado para su uso por el controlador de clase. No debe usarse.

Comentarios

El controlador de clase usa los elementos de HW_STREAM_INFORMATION para controlar las solicitudes de propiedad KSPROPSETID_Pin . El índice dentro de la estructura HW_STREAM_DESCRIPTOR actúa como número de identificador de tipo de patilla.

Tenga en cuenta que el controlador de clase no usa estos datos para controlar la propiedad KSPROPERTY_PIN_DATAINTERSECTION . Consulte STREAM_DATA_INTERSECT_INFO para obtener una descripción de cómo controla esta propiedad el controlador de clase.

Requisitos

Requisito Valor
Header strmini.h (incluya Strmini.h)

Consulte también

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER