SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR-Struktur (sidebandaudio.h)

Artikel
02/29/2024

Die SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR-Struktur 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_DESCRIPTOR {
  ULONG                               CbSize;
  GUID                                ContainerId;
  GUID                                Category;
  KSPIN_DATAFLOW                      Direction;
  SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
  UNICODE_STRING                      FriendlyName;
  ULONG                               VolumePropertyValuesSize;
  ULONG                               SidetoneVolumePropertyValueSize;
  ULONG                               MutePropertyValuesSize;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR;

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 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.

Direction

Gibt entweder KSPIN_DATAFLOW_IN oder KSPIN_DATAFLOW_OUT an. Siehe KSPIN_DATAFLOW.

Capabilities

Funktionen des Endpunkts wie (Stummschaltung, Lautstärke, Seitenton usw.). Siehe SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

Der Speicher für Anzeigename wird nach dem Deskriptor angefügt und ist in cbSize enthalten. Weitere Informationen finden Sie unter Anzeigenamen für Audioendpunktgeräte.

VolumePropertyValuesSize

Wenn die Remotevolumesteuerung unterstützt wird, enthält dieser Member die Größe der Daten, die von der IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES-Anforderung zurückgegeben werden.

SidetoneVolumePropertyValueSize

Wenn die Remotevolumesteuerung unterstützt wird, enthält dieser Member die Größe der Daten, die von der IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES-Anforderung zurückgegeben werden.

MutePropertyValuesSize

Wenn remote stummgeschaltet wird, enthält der Member die Größe der Daten, die von IOCTL_SBAUD_GET_MUTEPROPERTYVALUES zurückgegeben werden.