структура SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 (sidebandaudio.h)
Вторая версия структуры SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Эта версия позволяет драйверу контроллера предоставлять пользовательские свойства устройства для добавления в интерфейс звукового устройства.
В нем описываются характеристики боковой звуковой конечной точки. Звуковой драйвер должен запрашивать эти сведения, чтобы создать фильтр KS, представляющий эту конечную точку.
Синтаксис
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;
Члены
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.
FilterInterfacePropertyCount
Количество свойств устройства, которые необходимо добавить в интерфейс фабрики аудиофильтров.
FilterInterfaceProperties
Структура DEVPROPERTY , которая определяет настраиваемые свойства устройства, добавляемые в интерфейс звукового устройства.
Требования
| Требование | Ценность |
|---|---|
| заголовка | sidebandaudio.h |
См. также
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES