共用方式為


SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2結構 (sidebandaudio.h)

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 容器標識碼。 請參閱 音訊端點容器識別碼

Category

KSPIN_DESCRIPTOR。表示尺寸的類別。 指定 KS 針腳類別 GUID 的指標。 KS 針腳類別 GUID 會識別針腳所提供的一般功能類別。 KS 針腳類別 GUID 的範例包括KSNODETYPE_SPEAKER、KSNODETYPE_HEADPHONES和KSNODETYPE_MICROPHONE,全都定義在 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.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES