PKEY_AudioDevice_EnableEndpointByDefault

在 Windows 7 和更新版本的 Windows 中，端點產生器會將端點分類為尺寸。 這些規格是以核心串流 (KS) 端點所連線之釘選的 KSNODETYPE GUID 為基礎。 當音訊端點產生器列舉特定端點時，例如具有 UnknownFormFactor 等表單規格類型的端點時，端點產生器會將這些端點建立為已停用和隱藏。 因此，您必須在 主控台 中使用音效程式，才能使用這類端點。

如果您想要覆寫此行為，讓端點預設為啟用或停用，Windows 7 會提供可讓您執行此 動作的PKEY_AudioDevice_EnableEndpointByDefault 登錄機碼。

端點產生器會建立具有下列任何 KSNODETYPE 值的端點，如已停用和隱藏。

KS 節點類型	板型規格
KSNODETYPE_ANALOG_CONNECTOR	UnknownFormFactor
KSCATEGORY_AUDIO	UnknownFormFactor
KSNODETYPE_BIDIRECTIONAL_UNDEFINED	UnknownFormFactor
KSNODETYPE_EMBEDDED_UNDEFINED	UnknownFormFactor
KSNODETYPE_EQUALIZATION_NOISE	UnknownFormFactor
KSNODETYPE_EXTERNAL_UNDEFINED	UnknownFormFactor
KSNODETYPE_INPUT_UNDEFINED	UnknownFormFactor
KSNODETYPE_LEVEL_CALIBRATION_NOISE_SOURCE	UnknownFormFactor
KSNODETYPE_OUTPUT_UNDEFINED	UnknownFormFactor
KSNODETYPE_TELEPHONY_UNDEFINED	UnknownFormFactor

在 Windows 7 和更新版本的 Windows 中，具有 LineLevel 表單規格但 KSNODETYPE 不等於KSNODETYPE_LINE_CONNECTOR的端點也會建立為停用和隱藏。 下列端點屬於此類別。

KS 節點類型	板型規格
KSNODETYPE_1394_DA_STREAM	LineLevel
KSNODETYPE_1394_DV_STREAM_SOUNDTRACK	LineLevel
KSNODETYPE_ANALOG_TAPE	LineLevel
KSNODETYPE_CABLE_TUNER_AUDIO	LineLevel
KSNODETYPE_CD_PLAYER	LineLevel
KSNODETYPE_DAT_IO_DIGITAL_AUDIO_TAPE	LineLevel
KSNODETYPE_DCC_IO_DIGITAL_COMPACT_CASSETTE	LineLevel
KSNODETYPE_DSS_AUDIO	LineLevel
KSNODETYPE_DVD_AUDIO	LineLevel
KSNODETYPE_LEGACY_AUDIO_CONNECTOR	LineLevel
KSNODETYPE_MINIDISK	LineLevel
KSNODETYPE_MULTITRACK_RECORDER	LineLevel
KSNODETYPE_PHONOGRAPH	LineLevel
KSNODETYPE_RADIO_RECEIVER	LineLevel
KSNODETYPE_RADIO_TRANSMITTER	LineLevel
KSNODETYPE_SATELLITE_RECEIVER_AUDIO	LineLevel
KSNODETYPE_SYNTHESIZER	LineLevel
KSNODETYPE_TV_TUNER_AUDIO	LineLevel
KSNODETYPE_VCR_AUDIO	LineLevel
KSNODETYPE_VIDEO_DISC_AUDIO	LineLevel

下列 INF 檔案程式碼片段示範如何使用 PKEY_AudioDevice_EnableEndpointByDefault ，依預設啟用或停用端點。

[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 set default behavior of endpoint
[Xyz.AddReg]
HKR,"EP\\n",%PKEY_AudioEndpoint_Association%,,%KSNODETYPE_GUID%
HKR,"EP\\n",%PKEY_AudioDevice_EnableEndpointByDefault%,0x00010001,EnableEndpointByDefaultMaskValue
...

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

在上述範例中，EnableEndpointByDefaultMaskValue 代表 DWORD 遮罩值，這個值是啟用或停用旗標的組合， (FLAG_ENABLE或FLAG_DISABLE) ，以及資料流程旗標 (FLOW_MASK_RENDER或FLOW_MASK_CAPTURE) 。

下列 INF 檔案程式碼片段示範如何設定 CD 播放程式，以便預設啟用，並設定為輸入裝置 (FLOW_MASK_CAPTURE) 。

[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 is used to set default behavior of endpoint for CD player.
;; Enable by default for KSNODETYPE_CD_PLAYER
[MDVAD.EPProperties.AddReg]
HKR,"EP\\0",%PKEY_AudioEndpoint_Association%,,%KSNODETYPE_CD_PLAYER%
HKR,"EP\\0",%PKEY_AudioDevice_EnableEndpointByDefault%,0x00010001,0x00000201
...

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

在上述範例中，FLOW_MASK_CAPTURE和FLAG_ENABLE的位 OR 組合相當於0x00000200和0x00000001的位 OR 組合，且結果為 0x00000201。 下表顯示您可以搭配使用之旗標和遮罩的值 PKEY_AudioDevice_EnableEndpointByDefault。

旗標或端點遮罩	值
FLAG_DISABLE	0x00000000
FLAG_ENABLE	0x00000001
FLOW_MASK_CAPTURE	0x00000200
FLOW_MASK_RENDER	0x00000100