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 構造体 。
要件
| 要件 | 値 |
|---|---|
| Header | sidebandaudio.h |
こちらもご覧ください
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES