Compartilhar via


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 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, dataflow tem o valor KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT.

DataAccessible

Especifica VERDADEIRO se os dados de fluxo estiverem acessíveis ao 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 que esse fluxo dá suporte. (O nome deste membro é enganoso. Esse membro aponta para uma matriz de estruturas de 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 localizada 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 estruturas de KSPIN_MEDIUM com suporte por esse fluxo. Se o minidriver não especificar um meio, o driver de classe usará o KSMEDIUMSETID_STANDARD, KSMEDIUM_TYPE_ANYINSTANCE médio como o 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.

Observações

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)

Consulte também

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER