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,这些 GUID 都在 Ksmedia.h 中定义。 请参阅 Pin 类别属性

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

要求

要求 价值
标头 sidebandaudio.h

另请参阅

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES