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 容器 ID。 请参阅 音频终结点容器 ID

Category

KSPIN_DESCRIPTOR。用于指示外形规格的类别。 指定指向 KS 引脚类别 GUID 的指针。 KS 引脚类别 GUID 标识引脚提供的功能的常规类别。 KS 引脚类别 GUID 的示例包括 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 结构

要求

要求
Header sidebandaudio.h

另请参阅

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES