KSPIN_DESCRIPTOR-Struktur (ks.h)

Artikel
03/05/2024

Die KSPIN_DESCRIPTOR-Struktur beschreibt die grundlegenden KSPROPSETID_Pin Eigenschaften eines Pintyps.

Syntax

typedef struct {
  ULONG                 InterfacesCount;
  const KSPIN_INTERFACE *Interfaces;
  ULONG                 MediumsCount;
  const KSPIN_MEDIUM    *Mediums;
  ULONG                 DataRangesCount;
  const PKSDATARANGE    *DataRanges;
  KSPIN_DATAFLOW        DataFlow;
  KSPIN_COMMUNICATION   Communication;
  const GUID            *Category;
  const GUID            *Name;
  union {
    LONGLONG Reserved;
    struct {
      ULONG        ConstrainedDataRangesCount;
      PKSDATARANGE *ConstrainedDataRanges;
    };
  };
} KSPIN_DESCRIPTOR, *PKSPIN_DESCRIPTOR;

Member

InterfacesCount

Gibt die Größe des Arrays an, auf das von Schnittstellen verwiesen wird.

Interfaces

Ein Array von KSPIN_INTERFACE Strukturen, die die schnittstellen angeben, die von diesem Pintyp unterstützt werden.

MediumsCount

Gibt die Anzahl der Elemente im Array an, auf das von Mediums verwiesen wird.

Mediums

Ein Array von KSPIN_MEDIUM Strukturen, die die von diesem Pintyp unterstützten Medien angeben.

DataRangesCount

Gibt die Größe des Arrays an, auf das von DataRanges verwiesen wird.

DataRanges

Ein Array von KSDATARANGE-Strukturen , die die von diesem Pintyp unterstützten Datenbereiche angeben.

DataFlow

Gibt entweder KSPIN_DATAFLOW_IN oder KSPIN_DATAFLOW_OUT an. Siehe KSPROPERTY_PIN_DATAFLOW.

Communication

Gibt KSPIN_COMMUNICATION_NONE, KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE, KSPIN_COMMUNICATION_BOTH oder KSPIN_COMMUNICATION_BRIDGE an. Die Bedeutung der einzelnen Werte finden Sie unter KSPROPERTY_PIN_COMMUNICATION .

Category

Gibt einen Zeiger auf eine KS-Pinkategorie-GUID an. Die KS-Pinkategorie-GUID identifiziert die allgemeine Kategorie der Funktionen, die der Pin bereitstellt. Beispiele für KS-Pinkategorie-GUIDs sind KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES und KSNODETYPE_MICROPHONE, die alle in Ksmedia.h definiert sind. Weitere Informationen finden Sie unter Anheften der Kategorieeigenschaft.

Name

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

Reserved

Wird nicht verwendet. Ein Member einer unbenannten Union, die verwendet wird, um die richtige Ausrichtung der unbenannten Struktur zu erzwingen.

ConstrainedDataRangesCount

Gibt die Anzahl der Einträge im Array an, auf das von ConstrainedDataRanges verwiesen wird.

ConstrainedDataRanges

Verweist auf ein Array von KSDATARANGE-Strukturen . Gibt den Satz von Datenbereichen an, die der Pintyp derzeit unterstützt, basierend auf dem internen Zustand des Treibers.