Audio Endpoint Properties

Previous Next

Audio Endpoint Properties

Header file Mmdeviceapi.h defines several properties of audio endpoint devices in Windows Vista. The Windows audio service sets the values of these properties. Clients can read these properties, but should not set them.

This section describes only properties that apply exclusively to audio endpoint devices. The core audio APIs support additional properties that do not apply exclusively to audio endpoint devices. For more information about these additional properties, see Device Properties.

Property values are stored as PROPVARIANT structures. For information about PROPVARIANT, see the Windows SDK documentation.

For information about accessing the properties of an audio endpoint device through the device's IMMDevice interface, see Device Properties. For code examples that show how to access the properties of an audio endpoint device, see the following topics:

The following properties are specific to audio endpoint devices.

Property Description
PKEY_AudioEndpoint_Association Associates a kernel-streaming (KS) pin category with an audio endpoint device.
PKEY_AudioEndpoint_ControlPanelPageProvider Specifies the CLSID of the registered provider of the device-properties extension for the audio endpoint device.
PKEY_AudioEndpoint_Disable_SysFx Indicates whether system effects are enabled in the shared-mode stream that flows to or from the audio endpoint device.
PKEY_AudioEndpoint_FormFactor Indicates the physical attributes of the audio endpoint device.
PKEY_AudioEndpoint_FullRangeSpeakers Specifies the channel-configuration mask for the full-range speakers that are connected to the audio endpoint device.
PKEY_AudioEndpoint_GUID Supplies the DirectSound device identifier that corresponds to the audio endpoint device.
PKEY_AudioEndpoint_PhysicalSpeakers Defines the physical speaker configuration for the audio endpoint device.
PKEY_AudioEngine_DeviceFormat Specifies the device format, which is the format that the audio engine uses for the shared-mode stream that flows to or from the audio endpoint device.

See Also

Previous Next