SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 Struktur (sidebandaudio.h)
Die zweite Version der SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR Struktur. Mit dieser Version kann der Controllertreiber benutzerdefinierte Geräteeigenschaften bereitstellen, die der Schnittstelle des Audiogeräts hinzugefügt werden können.
Es beschreibt die Merkmale eines Sideband-Audioendpunkts. Der Audiotreiber sollte diese Informationen abfragen, um den KS-Filter zu erstellen, der diesen Endpunkt darstellt.
Syntax
typedef struct _SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 {
ULONG CbSize;
GUID ContainerId;
GUID Category;
KSPIN_DATAFLOW Direction;
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
UNICODE_STRING FriendlyName;
ULONG VolumePropertyValuesSize;
ULONG SidetoneVolumePropertyValueSize;
ULONG MutePropertyValuesSize;
ULONG FilterInterfacePropertyCount;
DEVPROPERTY *FilterInterfaceProperties;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2;
Member
CbSize
Größe des Deskriptors, einschließlich Speicher für UNICODE_STRING und alle zusätzlichen Daten.
ContainerId
Pnp-Container-ID für verbundenes Gerät. Weitere Informationen finden Sie unter Container-ID des Audioendpunkts.
Category
KSPIN_DESCRIPTOR. Kategorie zum Angeben des Formfaktors. Gibt einen Zeiger auf eine KS-Pinkategorie-GUID an. Die GUID der KS-Pinkategorie identifiziert die allgemeine Funktionskategorie, 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.
Direction
Gibt entweder KSPIN_DATAFLOW_IN oder KSPIN_DATAFLOW_OUT an. Siehe KSPIN_DATAFLOW.
Capabilities
Funktionen des Endpunkts wie (Stummschaltung, Lautstärke, Nebenton usw.). Siehe SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.
FriendlyName
Der Speicher für Anzeigename ist nach dem Deskriptor angefügt und in cbSize enthalten. Weitere Informationen finden Sie unter Anzeigenamen für Audioendpunktgeräte.
VolumePropertyValuesSize
Wenn die Remotevolumesteuerung unterstützt wird, enthält dieses Element die Größe der von der IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES Anforderung zurückgegebenen Daten.
SidetoneVolumePropertyValueSize
Wenn die Remotevolumesteuerung unterstützt wird, enthält dieses Element die Größe der von der IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES Anforderung zurückgegebenen Daten.
MutePropertyValuesSize
Wenn die Remote stummschaltung unterstützt wird, enthält das Element die Größe der von IOCTL_SBAUD_GET_MUTEPROPERTYVALUES zurückgegebenen Daten.
FilterInterfacePropertyCount
Die Anzahl der Geräteeigenschaften, die der Audiofilter factory-Schnittstelle hinzugefügt werden sollen.
FilterInterfaceProperties
Eine DEVPROPERTY-Struktur , die benutzerdefinierte Geräteeigenschaften definiert, die der Schnittstelle des Audiogeräts hinzugefügt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | sidebandaudio.h |
Weitere Informationen
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für