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

Статья
02/26/2024

Структура 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.