オーディオ エンドポイントのプロパティ
ヘッダー ファイル 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 | オーディオ エンドポイント デバイスの device-properties 拡張機能の登録済みプロバイダーの CLSID を指定します。 |
PKEY_AudioEndpoint_Disable_SysFx | オーディオ エンドポイント デバイスとの間を流れる共有モード ストリームでシステム効果を有効にするかどうかを示します。 |
PKEY_AudioEndpoint_FormFactor | オーディオ エンドポイント デバイスの物理属性を示します。 |
PKEY_AudioEndpoint_FullRangeSpeakers | オーディオ エンドポイント デバイスに接続されている全範囲スピーカーのチャネル構成マスクを指定します。 |
PKEY_AudioEndpoint_GUID | オーディオ エンドポイント デバイスに対応する DirectSound デバイス識別子を指定します。 |
PKEY_AudioEndpoint_PhysicalSpeakers | オーディオ エンドポイント デバイスの物理スピーカー構成を定義します。 |
PKEY_AudioEngine_DeviceFormat | オーディオ エンドポイント デバイスとの間で送受信される共有モード ストリームにオーディオ エンジンが使用する形式であるデバイス形式を指定します。 |
PKEY_AudioEngine_OEMFormat | ストリームのレンダリングまたはキャプチャに使用されるデバイスの既定の形式を指定します。 値は、.inf ファイル内の OEM によって設定されます。 |
PKEY_AudioEndpoint_Supports_EventDriven_Mode | エンドポイントがイベント ドリブン モードをサポートしているかどうかを示します。 値は、.inf ファイル内の OEM によって設定されます。 |
PKEY_AudioEndpoint_JackSubType | オーディオ エンドポイント デバイスの出力カテゴリ GUID が含まれています。 |
コア オーディオ API は、オーディオ エンドポイント デバイスにのみ適用されない追加のプロパティをサポートします。 これらの追加プロパティの詳細については、「デバイスのプロパティの」を参照してください。
関連トピック
-
オーディオ エンドポイント デバイスの を する