HW_STREAM_INFORMATION-Struktur (strmini.h)

  • Artikel

Die HW_STREAM_INFORMATION-Struktur beschreibt die Kernel-Streamingsemantik, die von einzelnen Streams als Teil einer HW_STREAM_DESCRIPTOR-Struktur unterstützt wird.

Syntax

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;

Member

NumberOfPossibleInstances

Gibt die Anzahl möglicher Instanzen dieses Datenstroms an, die geöffnet werden können.

DataFlow

Die Richtung, in die Daten in diesem Stream übertragen werden können. Für unidirektionale Datenflüsse hat DataFlow den Wert KSPIN_DATAFLOW_IN oder KSPIN_DATAFLOW_OUT.

DataAccessible

Gibt TRUE an, wenn der Klassentreiber auf die Streamdaten zugreifen kann.

NumberOfFormatArrayEntries

Die Anzahl der Einträge im Array, die an der Adresse im StreamFormatsArray-Element beginnt.

StreamFormatsArray

Zeiger auf den Anfang des Arrays von Datenbereichen, die von diesem Stream unterstützt werden. (Der Name dieses Members ist irreführend. Dieser Member verweist auf ein Array von KSDATARANGE-Strukturen , nicht auf KSDATAFORMAT-Strukturen.)

ClassReserved[4]

Reserviert für die Verwendung durch den Klassentreiber. Nicht verwenden.

NumStreamPropArrayEntries

Die Anzahl der Einträge im Array, die an der Adresse im StreamPropertiesArray-Element beginnt.

StreamPropertiesArray

Zeiger auf den Anfang des Arrays von Eigenschaftensätzen, die von diesem Stream unterstützt werden.

NumStreamEventArrayEntries

Die Anzahl der Einträge im Array, die an der Adresse im Feld StreamEventsArray beginnt.

StreamEventsArray

Zeiger auf den Anfang des Arrays von Ereignissätzen, die von diesem Stream unterstützt werden.

Category

Gibt die GUID der Pinkategorie an.

Name

Gibt die GUID des lokalisierten Unicode-Zeichenfolgennamens für den pin-Typ an, der in der Registrierung gespeichert ist.

MediumsCount

Die Anzahl der Einträge im Array, die an der Adresse im Feld Mediums beginnt.

Mediums

Zeiger auf den Anfang des Arrays von KSPIN_MEDIUM Strukturen, die von diesem Stream unterstützt werden. Wenn der Minitreiber kein Medium angibt, verwendet der Klassentreiber das KSMEDIUMSETID_STANDARD, KSMEDIUM_TYPE_ANYINSTANCE Medium als Standard.

BridgeStream

True ist der Kommunikationstyp des dem Datenstrom zugrunde liegenden Pintyps KSPIN_COMMUNICATION_BRIDGE. Andernfalls ist der Standardkommunikationstyp eines Datenstroms KSPIN_COMMUNICATION_SINK.

Die meisten Minidriver legen diesen Member auf FALSE fest. Eine Beschreibung der Kommunikationstypen finden Sie unter KSPROPERTY_PIN_COMMUNICATIONS.

Reserved[2]

Reserviert für die Verwendung durch den Klassentreiber. Nicht verwenden.

Hinweise

Der Klassentreiber verwendet die Elemente von HW_STREAM_INFORMATION, um die Anforderungen der KSPROPSETID_Pin-Eigenschaft zu verarbeiten. Der Index innerhalb der HW_STREAM_DESCRIPTOR-Struktur dient als Pintyp-ID-Nummer.

Beachten Sie, dass der Klassentreiber diese Daten nicht verwendet, um die KSPROPERTY_PIN_DATAINTERSECTION-Eigenschaft zu verarbeiten. Eine Beschreibung, wie der Klassentreiber diese Eigenschaft behandelt, finden Sie unter STREAM_DATA_INTERSECT_INFO .

Anforderungen

Anforderung Wert
Header strmini.h (include Strmini.h)

Weitere Informationen

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER