次の方法で共有


SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2構造体 (sidebandaudio.h)

SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR構造体の 2 番目のバージョン。 このバージョンでは、コントローラー ドライバーがオーディオ デバイスのインターフェイスに追加するカスタム デバイス プロパティを提供できます。

サイドバンド オーディオ エンドポイントの特性について説明します。 オーディオ ドライバーは、この情報を照会して、このエンドポイントを表す 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 で定義されています。 「Pin Category プロパティの」を参照してください。

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