Partager via


PKEY_Devices_AudioDevice_Microphone_IsFarField

Dans Windows 10 19H1 et versions ultérieures, la clé de propriété PKEY_Devices_AudioDevice_Microphone_IsFarField indique si le microphone capture l’audio du champ lointain.

À partir de Windows 10 19H1, l’utilisation de la propriété PKEY_Devices_AudioDevice_Microphone_IsFarField est une exigence pour les systèmes qui prennent en charge l’audio de champ lointain, généralement pour une utilisation par un assistant vocal.

La valeur 1 indique que le microphone capturera l’audio de champ lointain, ce qui fera du microphone un point de terminaison préféré pour un assistant vocal.

La valeur 0 ou aucune clé de propriété indique que le microphone ne prend pas en charge le champ lointain ou que la prise en charge est inconnue, de sorte que le point de terminaison n’est pas hiérarchisé pour une utilisation par un assistant vocal.

La propriété doit être définie via INF, et de préférence une extension INF fournie par l’OEM par opposition à l’INF de base pour le périphérique audio. Pour plus d’informations sur les fichiers INF d’extension, consultez Création d’une installation de pilote audio en composants et Utilisation d’un fichier INF d’extension.

Exemple de fichier INF

L’exemple de fichier Sysvad ComponentizedAudioSampleExtension.inf inclut cette propriété. L’exemple montre la valeur définie sur 0x1 indiquant que le microphone capture l’audio de champ lointain.

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

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 10 version 19H1
En-tête Ksmedia.h

Media-Class INF Extensions