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_ENDPOINT_CAPABILITIES