структура SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR (sidebandaudio.h)

Статья
02/07/2025

Структура SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR описывает характеристики боковой звуковой конечной точки. Звуковой драйвер должен запрашивать эти сведения, чтобы создать фильтр KS, представляющий эту конечную точку.

Синтаксис

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;

Члены

CbSize

Размер дескриптора, включая хранилище для UNICODE_STRING и любых дополнительных данных.

ContainerId

Идентификатор контейнера Pnp для подключенного устройства. См. идентификатор контейнера конечной точки звука.

Category

KSPIN_DESCRIPTOR. Категория для указания форм-фактора. Указывает указатель на GUID категории контактов KS. GUID категории контактов KS определяет общую категорию функциональных возможностей, которые предоставляет пин-код. Примерами идентификаторов GUID категории пин-кода KS являются KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES и KSNODETYPE_MICROPHONE, которые определены в Ksmedia.h. См. свойств категории закреплений.

Direction

Указывает KSPIN_DATAFLOW_IN или KSPIN_DATAFLOW_OUT. См. KSPIN_DATAFLOW.

Capabilities

Возможности конечной точки, например (отключение звука, громкости, боковой стороны и т. д.). См. SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

Хранилище для понятного имени присоединено после дескриптора и включено в cbSize. См. понятные имена устройств аудио конечной точки.

VolumePropertyValuesSize

Если поддерживается удаленное управление томом, этот элемент содержит размер данных, возвращаемых запросом IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES.

SidetoneVolumePropertyValueSize

Если поддерживается удаленное управление томом, этот элемент содержит размер данных, возвращаемых запросом IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES.

MutePropertyValuesSize

Если поддерживается удаленное отключение, элемент содержит размер данных, возвращаемых IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.