SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR结构的第二个版本。 此版本允许控制器驱动程序提供自定义设备属性,以添加到音频设备的接口。
它描述 Sideband 音频终结点的特征。 音频驱动程序应查询此信息以生成表示此终结点的 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,这些 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返回的数据大小。
FilterInterfacePropertyCount
应添加到音频筛选器工厂接口的设备属性数。
FilterInterfaceProperties
DEVPROPERTY 结构,用于定义添加到音频设备的接口的自定义设备属性。
要求
要求 | 价值 |
---|---|
标头 | sidebandaudio.h |
另请参阅
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES