PKEY_AudioDevice_NeverSetAsDefaultEndpoint

È possibile decidere di configurare determinati dispositivi in modo che non possano mai essere selezionati come dispositivi predefiniti. Queste includono, ad esempio, linee modem e dispositivi audio medici. Windows 7 e versioni successive di Windows forniscono la chiave del Registro di sistema PKEY_AudioDevice_NeverSetAsDefaultEndpoint per impedire la selezione dell'endpoint di un dispositivo come endpoint predefinito.

L'estratto del file INF seguente illustra come usare PKEY_AudioDevice_NeverSetAsDefaultEndpoint per configurare un endpoint in modo che non possa mai essere selezionato come predefinito.

[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"
...

Nell'esempio precedente, NeverSetAsDefaultEndpointMaskValue rappresenta un valore di maschera DWORD che rappresenta una combinazione di flag di ruolo del dispositivo e flag di flusso di dati.

Il frammento di file INF seguente mostra come viene configurato un dispositivo di output non definito (KSNODETYPE_OUTPUT_UNDEFINED) in modo che l'endpoint non sia mai selezionato come predefinito, indipendentemente dal ruolo del dispositivo e dalla direzione del flusso di dati.

[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"

Nell'esempio precedente 0x00000305 è la combinazione OR bit per bit di tutti i flag e maschere disponibili per PKEY_AudioDevice_NeverSetAsDefaultEndpoint. La tabella seguente mostra i flag e le maschere e i relativi valori.

Contrassegno o maschera dell'endpoint	Valore
FLOW_MASK_CAPTURE	0x00000200
FLOW_MASK_RENDER	0x00000100
ROLE_MASK_COMMUNICATION	0x00000004
ROLE_MASK_CONSOLE	0x00000001