Edit

Share via

ERole enumeration (mmdeviceapi.h)

  • Article

The ERole enumeration defines constants that indicate the role that the system has assigned to an audio endpoint device.

Syntax

typedef enum __MIDL___MIDL_itf_mmdeviceapi_0000_0000_0002 {
  eConsole = 0,
  eMultimedia,
  eCommunications,
  ERole_enum_count
} ERole;

Constants

 
eConsole
Value: 0
Games, system notification sounds, and voice commands.
eMultimedia
Music, movies, narration, and live music recording.
eCommunications
Voice communications (talking to another person).
ERole_enum_count
The number of members in the ERole enumeration (not counting the ERole_enum_count member).

Remarks

The IMMDeviceEnumerator::GetDefaultAudioEndpoint and IMMNotificationClient::OnDefaultDeviceChanged methods use the constants defined in the ERole enumeration.

For more information, see Device Roles.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header mmdeviceapi.h

See also

Core Audio Enumerations

IMMDeviceEnumerator::GetDefaultAudioEndpoint

IMMNotificationClient::OnDefaultDeviceChanged