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) |