PKEY_Devices_AudioDevice_Microphone_IsFarField

Windows 10 19H1 以降では、PKEY_Devices_AudioDevice_Microphone_IsFarField プロパティキーは、マイクが遠距離音声をキャプチャするかどうかを示します。

Windows 10 19H1 以降、遠距離音声 (通常は音声アシスタントで使用する場合) をサポートするシステムの要件として、PKEY_Devices_AudioDevice_Microphone_IsFarField プロパティの使用が必要になります。

値 1 は、マイクが遠距離音声をキャプチャすることを示し、マイクが音声アシスタントの優先エンドポイントになります。

値が 0 であるか、プロパティキーがない場合は、マイクがファーフィールドをサポートしていないか、サポートが不明であるため、音声アシスタントによる使用に対してエンドポイントが優先されないことを示します。

プロパティはINFを介して設定する必要があり、できればオーディオデバイスのベースINFとは逆にOEMから提供される拡張INFを使用して設定する必要があります。拡張INFファイルの詳細については、「コンポーネント化されたオーディオドライバインストールの作成」と「拡張INFファイルの使用」を参照してください。

INFファイルのサンプル

Sysvad サンプルの ComponentizedAudioSampleExtension.inf ファイルには、このプロパティが含まれています。このサンプルでは、マイクが遠距離音声をキャプチャすることを示す値が 0x1 に設定されています。

;HKR,EP\1,%PKEY_Devices_AudioDevice_Microphone_IsFarField%,0x00010001,0x1

要件	Value
サポートされている最小のクライアント	Windows 10 バージョン 19H1
ヘッダー	Ksmedia.h