Compartilhar via


PKEY_Devices_AudioDevice_Microphone_IsFarField

No Windows 10 19H1 e posterior, a PKEY_Devices_AudioDevice_Microphone_IsFarField chave de propriedade indica se o microfone capturará áudio de campo distante.

A partir do Windows 10 19H1, usar a propriedade PKEY_Devices_AudioDevice_Microphone_IsFarField é um requisito para sistemas que dão suporte a áudio de campo distante, normalmente para uso por um assistente de voz.

Um valor 1 indica que o microfone capturará áudio de campo distante, o que tornará o microfone um ponto de extremidade preferencial para um assistente de voz.

Um valor de 0 ou nenhuma chave de propriedade indica que o microfone não dá suporte a campo distante ou o suporte é desconhecido, portanto, o ponto de extremidade não será priorizado para uso por um assistente de voz.

A propriedade deve ser definida via INF e, preferencialmente, uma extensão INF fornecida pelo OEM em vez do INF base para o dispositivo de áudio. Para obter mais informações sobre arquivos INF de extensão, consulte Criando uma instalação de driver de áudio com componentes e Usando um arquivo INF de extensão.

Exemplo de arquivo INF

O arquivo ComponentizedAudioSampleExtension.inf de exemplo do sysvad inclui essa propriedade. O exemplo mostra o valor definido como 0x1 indicando que o microfone captura áudio de campo distante.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 versão 19H1
parâmetro Ksmedia.h

Extensões INF de classe de mídia