KSPIN_DESCRIPTOR Struktur (ks.h)
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;
Angehörige
InterfacesCount
Gibt die Größe des Arrays an, auf das durch Schnittstellenverwiesen wird.
Interfaces
Ein Array von KSPIN_INTERFACE Strukturen, die die von diesem Pintyp unterstützten Schnittstellen angeben.
MediumsCount
Gibt die Anzahl der Elemente im Array an, auf die durch Mediumsverwiesen 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 DataRanges-verweist.
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. Siehe KSPROPERTY_PIN_COMMUNICATION für die Bedeutung der einzelnen Werte.
Category
Gibt einen Zeiger auf eine KS-Pin-Kategorie-GUID an. Die GUID der KS-Pinkategorie identifiziert die allgemeine Funktionskategorie, die der Pin bereitstellt. Beispiele für KS-Pin-Kategorie-GUIDs sind KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES und KSNODETYPE_MICROPHONE, die alle in Ksmedia.hdefiniert sind. Siehe auch Pin Category Property.
Name
Gibt die GUID des lokalisierten Unicode-Zeichenfolgennamens für den Pintyp an, der in der Registrierung gespeichert ist.
Reserved
Wird nicht verwendet. Ein Mitglied einer nicht benannten Union, die verwendet wird, um die richtige Ausrichtung auf die unbenannte Struktur zu erzwingen.
ConstrainedDataRangesCount
Gibt die Anzahl der Einträge im Array an, auf die durch "ConstrainedDataRanges"verwiesen wird.
ConstrainedDataRanges
Verweist auf ein Array von KSDATARANGE- Strukturen. Gibt die Gruppe von Datenbereichen an, die der Pintyp derzeit unterstützt, basierend auf dem internen Zustand des Treibers.
Bemerkungen
Treiber definieren in der Regel eine KSPIN_DESCRIPTOR Struktur für jeden unterstützten Pintyp.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ks.h (enthalten Ks.h) |