Core Audio Properties
This programming reference for the Core Audio SDK includes the following properties.
Audio Endpoint Properties
Core Audio SDK includes several properties of audio endpoint devices. For more information, see Audio Endpoint Properties.
The following properties are defined in Mmdeviceapi.h in Windows Vista and later.
| 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. |
|
Specifies the default format of the device that is used for rendering or capturing a stream. The values are populated by the OEM in an .inf file. | |
|
Indicates whether the endpoint supports the event-driven mode. The values are populated by the OEM in an .inf file. | |
|
Contains an output category GUID for an audio endpoint device. |
Device Properties
Core Audio SDK includes several device properties of audio endpoint devices. For more information, see Device Properties.
The following properties are defined in Functiondiscoverykeys_devpkey.h in Windows Vista and later.
| Property | Description |
|---|---|
| PKEY_DeviceInterface_FriendlyName | The friendly name of the audio adapter to which the endpoint device is attached (for example, "XYZ Audio Adapter"). |
| PKEY_Device_DeviceDesc | The device description of the endpoint device (for example, "Speakers"). |
| PKEY_Device_FriendlyName | The friendly name of the endpoint device (for example, "Speakers (XYZ Audio Adapter)"). |
| PKEY_Device_ContainerId | Stores the container identifier of the PnP device that implements the audio endpoint. For more information about this property, see "Device Property Reference" in the Windows WDK documentation. |
Related topics