Compartilhar via


PKEY_AudioDevice_NeverSetAsDefaultEndpoint

Você pode decidir configurar determinados dispositivos para que eles nunca possam ser selecionados como dispositivos padrão. Isso inclui, por exemplo, linhas de modem e dispositivos de áudio médico. O Windows 7 e versões posteriores do Windows fornecem o PKEY_AudioDevice_NeverSetAsDefaultEndpoint chave do Registro para permitir que você impeça a seleção do ponto de extremidade de um dispositivo como o ponto de extremidade padrão.

O trecho de arquivo INF a seguir mostra como usar PKEY_AudioDevice_NeverSetAsDefaultEndpoint para configurar um ponto de extremidade para que ele nunca possa ser selecionado como padrão.

[Version]
...
Class=MEDIA
ClassGuid={4d36e96c-e325-11ce-bfc1-08002be10318}
...

[USBAudio]
...

[USBAudio.Interfaces]
AddInterface=%KSCATEGORY_AUDIO%,"GLOBAL",USBAudio.Interface
...

[USBAudio.Interface]
AddReg=Xyz.AddReg
...

;; AddReg section to setup endpoint so that
;; it cannot be selected as the default endpoint.
[Xyz.AddReg]
HKR,"EP\\n",%PKEY_AudioEndpoint_Association%,,%KSNODETYPE_GUID%
HKR,"EP\\n",%PKEY_AudioDevice_NeverSetAsDefaultEndpoint%,0x00010001,NeverSetAsDefaultEndpointMaskValue
...

[Strings]
KSCATEGORY_AUDIO="{6994AD04-93EF-11D0-A3CC-00A0C9223196}"
PKEY_AudioEndpoint_Association="{1DA5D803-D492-4EDD-8C23-E0C0FFEE7F0E},2"
PKEY_AudioDevice_NeverSetAsDefaultEndpoint = "{F3E80BEF-1723-4FF2-BCC4-7F83DC5E46D4},3"
...

No exemplo anterior, NeverSetAsDefaultEndpointMaskValue representa um valor de máscara DWORD que é uma combinação de sinalizadores de função de dispositivo e sinalizadores de fluxo de dados.

O snippet de arquivo INF a seguir mostra como um dispositivo de saída indefinido (KSNODETYPE_OUTPUT_UNDEFINED) é configurado para que seu ponto de extremidade nunca seja selecionado como padrão, independentemente da função do dispositivo e da direção do fluxo de dados.

[Version]
...
Class=MEDIA
ClassGuid={4d36e96c-e325-11ce-bfc1-08002be10318}
...

[USBAudio]
...

[USBAudio.Interfaces]
AddInterface=%KSCATEGORY_AUDIO%,"GLOBAL",USBAudio.Interface
...

[USBAudio.Interface]
AddReg=MDVAD.EPProperties.AddReg
...

;; AddReg section to setup endpoint so that
;; it cannot be selected as the default endpoint.
[MDVAD.EPProperties.AddReg]
HKR,"EP\\0",%PKEY_AudioEndpoint_Association%,,%KSNODETYPE_OUTPUT_UNDEFINED%
HKR,"EP\\0",%PKEY_AudioDevice_NeverSetAsDefaultEndpoint%,0x00010001,0x00000305
...

[Strings]
KSCATEGORY_AUDIO="{6994AD04-93EF-11D0-A3CC-00A0C9223196}"
KSNODETYPE_OUTPUT_UNDEFINED="{DFF21CE0-F70F-11D0-B917-00A0C9223196}"
PKEY_AudioEndpoint_Association="{1DA5D803-D492-4EDD-8C23-E0C0FFEE7F0E},2"
PKEY_AudioDevice_NeverSetAsDefaultEndpoint = "{F3E80BEF-1723-4FF2-BCC4-7F83DC5E46D4},3"

No exemplo anterior, 0x00000305 é a combinação OR bit a bit de todos os sinalizadores e máscaras disponíveis para PKEY_AudioDevice_NeverSetAsDefaultEndpoint. A tabela a seguir mostra os sinalizadores e máscaras e seus valores.

Sinalizador ou máscara de ponto de extremidade Valor

FLOW_MASK_CAPTURE

0x00000200

FLOW_MASK_RENDER

0x00000100

ROLE_MASK_COMMUNICATION

0x00000004

ROLE_MASK_CONSOLE

0x00000001