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_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES