GetDefaultAudioRenderId

July 21, 2014

Applies to: Windows Phone 8 and Windows Phone Silverlight 8.1 only

This method returns the audio render interface ID for the specified role.

LPCWSTR GetDefaultAudioCaptureId(
AudioDeviceRole role
);

Parameters

  • role
    [in] A member of the AudioDeviceRole enumeration indicating the role for which audio interface ID is being requested.

Return Value

A string containing the requested interface ID. This value can then be passed into ActivateAudioInterface. Returns NULL if the requested interface is not found. Apps must free the memory of the returned string using CoTaskMemFree.

Remarks

This method is similar to the GetDefaultAudioRenderId(AudioDeviceRole) method on the desktop.

Warning

Your application must have the ID_CAP_MICROPHONE in order to capture audio. Your application must have the ID_CAP_VOIP capability and use the Communications audio device role in order to render or capture audio in the background or to mute or pause lower-priority audio streams during playback. For more information on capabilities, see App capabilities and hardware requirements for Windows Phone 8.

Requirements

Minimum supported phone

Windows Phone 8

Header

phoneaudioclient.h

Static library

Phoneaudioses.lib

Runtime library

Phoneaudioses.dll