SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR 结构 (sidebandaudio.h)

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 容器 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返回的数据大小。

要求

要求
Header sidebandaudio.h

另请参阅

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES