estrutura HW_STREAM_INFORMATION (strmini.h)
A estrutura HW_STREAM_INFORMATION descreve a semântica de streaming de kernel com suporte por fluxos individuais, como parte de uma estrutura de HW_STREAM_DESCRIPTOR .
Sintaxe
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;
Membros
NumberOfPossibleInstances
Especifica o número de instâncias possíveis desse fluxo que podem ser abertas.
DataFlow
A direção que os dados podem percorrer neste fluxo. Para o fluxo de dados unidirecional, o DataFlow tem o valor KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT.
DataAccessible
Especifica TRUE se os dados de fluxo estiverem acessíveis para o driver de classe.
NumberOfFormatArrayEntries
O número de entradas na matriz que começa no endereço no membro StreamFormatsArray .
StreamFormatsArray
Ponteiro para o início da matriz de intervalos de dados aos quais esse fluxo dá suporte. (O nome deste membro é enganoso. Esse membro aponta para uma matriz de estruturas KSDATARANGE , não estruturas KSDATAFORMAT.)
ClassReserved[4]
Reservado para uso pelo driver de classe. Não use.
NumStreamPropArrayEntries
O número de entradas na matriz que começa no endereço no membro StreamPropertiesArray .
StreamPropertiesArray
Ponteiro para o início da matriz de conjuntos de propriedades com suporte por esse fluxo.
NumStreamEventArrayEntries
O número de entradas na matriz que começa no endereço no campo StreamEventsArray .
StreamEventsArray
Ponteiro para o início da matriz de conjuntos de eventos com suporte por esse fluxo.
Category
Especifica o GUID da categoria de pino.
Name
Especifica o GUID do nome da cadeia de caracteres Unicode localizado para o tipo de pino, armazenado no Registro.
MediumsCount
O número de entradas na matriz que começa no endereço no campo Médias .
Mediums
Ponteiro para o início da matriz de KSPIN_MEDIUM estruturas compatíveis com esse fluxo. Se o minidriver não especificar um meio, o driver de classe usará o KSMEDIUMSETID_STANDARD, KSMEDIUM_TYPE_ANYINSTANCE médio como padrão.
BridgeStream
Se TRUE, o tipo de comunicação do tipo de pino subjacente desse fluxo será KSPIN_COMMUNICATION_BRIDGE. Caso contrário, o tipo de comunicação padrão de um fluxo é KSPIN_COMMUNICATION_SINK.
A maioria dos minidrivers definirá esse membro como FALSE. Consulte KSPROPERTY_PIN_COMMUNICATIONS para obter uma descrição dos tipos de comunicação.
Reserved[2]
Reservado para uso pelo driver de classe. Não use.
Comentários
O driver de classe usa os elementos de HW_STREAM_INFORMATION para lidar com as solicitações de propriedade KSPROPSETID_Pin . O índice dentro da estrutura HW_STREAM_DESCRIPTOR serve como o número de ID do tipo de pino.
Observe que o driver de classe não usa esses dados para lidar com a propriedade KSPROPERTY_PIN_DATAINTERSECTION . Consulte STREAM_DATA_INTERSECT_INFO para obter uma descrição de como o driver de classe lida com essa propriedade.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | strmini.h (inclua Strmini.h) |