オーディオ エンドポイントのプロパティ
ヘッダー ファイル Mmdeviceapi.h は、Windows Vista 以降におけるオーディオ エンドポイント デバイスのいくつかのプロパティを定義します。 Windows オーディオ サービスは、これらのプロパティの値を設定します。 クライアントは、これらのプロパティを読み取ることができますが、設定してはなりません。 プロパティ値は PROPVARIANT 構造として格納されます。
オーディオ入力デバイスのプロパティの推奨される読み取り方法は、Windows.Devices.Enumeration 名前空間の API を使用することです。 これらの API は、Windows ストア アプリとデスクトップ アプリでサポートされています。 IMMDevice インターフェイスを使用してデバイス プロパティを読み取る既存のデスクトップ アプリについては、「デバイスのプロパティ」をご覧ください。 IMMDevice は、Windows ストア アプリではサポートされていません。
オーディオ エンドポイント デバイスのプロパティにアクセスする方法を示すコード例については、次のトピックをご覧ください。
PROPVARIANT の詳細については、Windows SDK のマニュアルを参照してください。
次のプロパティは、オーディオ エンドポイント デバイスに固有です。
| プロパティ | 説明 |
|---|---|
| PKEY_AudioEndpoint_Association | カーネル ストリーミング (KS) ピン カテゴリをオーディオ エンドポイント デバイスに関連付けます。 |
| PKEY_AudioEndpoint_ControlPanelPageProvider | オーディオ エンドポイント デバイスのデバイス プロパティ拡張機能の登録済みプロバイダーの CLSID を指定します。 |
| PKEY_AudioEndpoint_Disable_SysFx | オーディオ エンドポイント デバイスとの間を流れる共有モード ストリームでシステム効果を有効にするかどうかを指定します。 |
| PKEY_AudioEndpoint_FormFactor | オーディオ エンドポイント デバイスの物理属性を指定します。 |
| PKEY_AudioEndpoint_FullRangeSpeakers | オーディオ エンドポイント デバイスに接続されている全範囲スピーカーのチャネル構成マスクを指定します。 |
| PKEY_AudioEndpoint_GUID | オーディオ エンドポイント デバイスに対応する DirectSound デバイス識別子を指定します。 |
| PKEY_AudioEndpoint_PhysicalSpeakers | オーディオ エンドポイント デバイスの物理スピーカー構成を定義します。 |
| PKEY_AudioEngine_DeviceFormat | デバイス形式 (オーディオ エンドポイント デバイスとの間を流れる共有モード ストリームにオーディオ エンジンが使用する形式) を指定します。 |
| PKEY_AudioEngine_OEMFormat | ストリームのレンダリングまたはキャプチャに使用されるデバイスの既定の形式を指定します。 値は、OEM によって .inf ファイル内に入力されます。 |
| PKEY_AudioEndpoint_Supports_EventDriven_Mode | エンドポイントがイベント駆動型モードをサポートしているかどうかを指定します。 値は、OEM によって .inf ファイル内に入力されます。 |
| PKEY_AudioEndpoint_JackSubType | オーディオ エンドポイント デバイスの出力カテゴリ GUID が含まれています。 |
コア オーディオ API は、オーディオ エンドポイント デバイスに排他的に適用されない追加のプロパティをサポートします。 これらの追加プロパティについて詳しくは、「デバイスのプロパティ」をご覧ください。