HW_STREAM_INFORMATION struttura (strmini.h)

Articolo
08/07/2023

La struttura HW_STREAM_INFORMATION descrive la semantica di streaming del kernel supportata da singoli flussi, come parte di una struttura HW_STREAM_DESCRIPTOR .

Sintassi

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;

Members

NumberOfPossibleInstances

Specifica il numero di istanze possibili di questo flusso che possono essere aperte.

DataFlow

Direzione in cui i dati possono viaggiare su questo flusso. Per il flusso di dati unidirectional, DataFlow ha il valore KSPIN_DATAFLOW_IN o KSPIN_DATAFLOW_OUT .

DataAccessible

Specifica TRUE se i dati di flusso sono accessibili al driver di classe.

NumberOfFormatArrayEntries

Numero di voci nella matrice che inizia all'indirizzo nel membro StreamFormatsArray .

StreamFormatsArray

Puntatore all'inizio della matrice di intervalli di dati supportati da questo flusso. Il nome di questo membro è ingannevole. Questo membro punta a una matrice di strutture KSDATARANGE, non KSDATAFORMAT .

ClassReserved[4]

Riservato per l'uso da parte del driver di classe. Non usare.

NumStreamPropArrayEntries

Numero di voci nella matrice che inizia all'indirizzo del membro StreamPropertiesArray .

StreamPropertiesArray

Puntatore all'inizio della matrice di set di proprietà supportati da questo flusso.

NumStreamEventArrayEntries

Numero di voci nella matrice che inizia all'indirizzo nel campo StreamEventsArray .

StreamEventsArray

Puntatore all'inizio della matrice di set di eventi supportati da questo flusso.

Category

Specifica il GUID della categoria di pin.

Name

Specifica il GUID del nome stringa Unicode localizzato per il tipo di pin archiviato nel Registro di sistema.

MediumsCount

Numero di voci nella matrice che inizia all'indirizzo nel campo Mediums .

Mediums

Puntatore all'inizio della matrice di strutture KSPIN_MEDIUM supportate da questo flusso. Se il minidriver non specifica un supporto, il driver di classe usa il KSMEDIUMSETID_STANDARD, KSMEDIUM_TYPE_ANYINSTANCE medio come impostazione predefinita.

BridgeStream

Se TRUE, il tipo di pin sottostante del flusso è KSPIN_COMMUNICATION_BRIDGE. In caso contrario, il tipo di comunicazione predefinito di un flusso è KSPIN_COMMUNICATION_SINK.

La maggior parte dei minidriver imposta questo membro su FALSE. Per una descrizione dei tipi di comunicazione, vedere KSPROPERTY_PIN_COMMUNICATIONS.

Reserved[2]

Riservato per l'uso da parte del driver di classe. Non usare.

Commenti

Il driver di classe usa gli elementi di HW_STREAM_INFORMATION per gestire le richieste di proprietà KSPROPSETID_Pin . L'indice all'interno della struttura HW_STREAM_DESCRIPTOR funge da numero ID di tipo pin.

Si noti che il driver della classe non usa questi dati per gestire la proprietà KSPROPERTY_PIN_DATAINTERSECTION . Vedere STREAM_DATA_INTERSECT_INFO per una descrizione del modo in cui il driver di classe gestisce questa proprietà.

Requisiti

Requisito	Valore
Intestazione	strmini.h (include Strmini.h)

Vedi anche

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

Condividi tramite