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