オーディオ エンドポイントのプロパティ

  • [アーティクル]

ヘッダー ファイル 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 は、オーディオ エンドポイント デバイスに排他的に適用されない追加のプロパティをサポートします。 これらの追加プロパティについて詳しくは、「デバイスのプロパティ」をご覧ください。

オーディオ エンドポイント デバイス

プログラミング リファレンス