Share via

SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR構造体 (sidebandaudio.h)

  • [アーティクル]

SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR構造では、サイドバンド オーディオ エンドポイントの特性について説明します。 オーディオ ドライバーは、この情報に対してクエリを実行して、このエンドポイントを表す KS フィルターを作成する必要があります。

構文

typedef struct _SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR {
  ULONG                               CbSize;
  GUID                                ContainerId;
  GUID                                Category;
  KSPIN_DATAFLOW                      Direction;
  SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
  UNICODE_STRING                      FriendlyName;
  ULONG                               VolumePropertyValuesSize;
  ULONG                               SidetoneVolumePropertyValueSize;
  ULONG                               MutePropertyValuesSize;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR;

メンバー

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によって返されるデータのサイズが含まれます。

要件

要件 値
Header sidebandaudio.h

こちらもご覧ください

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES