PKEY_AudioEndpoint_Disable_SysFx Property

PKEY_AudioEndpoint_Disable_SysFx Property

The PKEY_AudioEndpoint_Disable_SysFx property specifies whether system effects are enabled in the shared-mode stream that flows to or from the audio endpoint device.

System effects are implemented as audio processing objects (APOs) that can be inserted into an audio stream. APOs are software modules that perform audio processing functions such as volume control and format conversion. Disabling the system effects for an endpoint device enables the associated stream to pass through the APOs unmodified.

For more information about system effects in Windows Vista, see the white papers titled "Custom Audio Effects in Windows Vista" and "Reusing Windows Vista Audio System Effects" at the Audio Device Technologies for Windows Web site.

This property applies only to the local-effects and global-effects APOs that were installed by the .inf file that installed the audio adapter to which the endpoint device is connected. In addition, this property affects only the target endpoint device—it has no effect on the system effects for any other endpoint devices, even if they connect to the same adapter.

The vt member of the PROPVARIANT structure is set to VT_BOOL.

The boolVal member of the PROPVARIANT structure is set to TRUE if system effects are disabled or to FALSE if they are enabled.

Requirements

Client: Windows Vista

Header: Include Mmdeviceapi.h.

See Also

• Audio Endpoint Properties