Share via


Audio Gateway Registry Settings (Compact 2013)

3/26/2014

Windows Embedded Compact provides the Audio Gateway service to support the Hands-Free Profile on the device. You can configure the Audio Gateway service through the registry.

Note

The default registry values vary depending on which catalog items are included in your OS design.

To enable the Hands-Free Profile on the device, add the HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\HandsfreeProfileOn key to the registry. This registry key is not added by default because not all devices support Bluetooth.

You can configure the Audio Gateway by using these registry entries, located in the key HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\AudioGateway.

Name

Type

Description

Default

Authenticate

REG_DWORD

Optional. Whether the connection is authenticated.

  • 0 = Disables authentication.
  • 1 = Enables authentication.
Ee495798.Caution(en-us,WinEmbedded.80).gifCaution:
Disabling authentication is a potential security risk.

1

ConnectHFOnCall

REG_DWORD

Specifies whether hands-freeoperation is activated when a call is received.

  • 0 = Disables activation.
  • 1 = Enables activation.

0

ConnectScoInAlways

REG_DWORD

Whether audio is routed to the Bluetooth hands-free device.

  • 0 = Incoming calls answered in the handset and audio is not routed to the hands-free device.
  • 1 = Incoming calls answered in the handset and routes audio to the hands-free device.

0

Encrypt

REG_DWORD

Optional. Whether the connection is encrypted.

  • 0 = Disables encryption.
  • 1 = Enables encryption.
Ee495798.Caution(en-us,WinEmbedded.80).gifCaution:
Disabling encryption is a potential security risk.

1

ESCOMaxLatency

REG_DWORD

Specifies an upper bound on the latency of the Extended Synchronous Connection Oriented (eSCO) data and sets bounds onthe maximum number of retransmissions and the eSCO interval.

ESCORetransmission

REG_DWORD

Specifies the number of retransmissions and the eSCO interval.

ESCORxBandwidth

REG_DWORD

Specifies the eSCO reception bandwidth.

ESCOTxBandwidt

REG_DWORD

Specifies the eSCO transmission bandwidth.

ESCOVoiceSetting

REG_DWORD

Specifies whether a voice channel on the device is activated.

  • 0 = Disables the voice channel.
  • 1 = Enables the voice channel.

0

MapAudioToPcmMode

REG_DWORD

Specifies the audio driver.

  • 0 = Use the built-in SCO audio driver.
  • 1 = Assume that audio is automatically routed to the Bluetooth hardware.

1

MicVolume

REG_DWORD

The default microphone volume with respect to the AT+VGM command.

8

NoHandsFree

REG_DWORD

Whether the Hands-Free Profile is used.

  • 0 = Enables the Hands-Free Profile.
  • 1 = Disables the Hands-Free Profile.

PowerSave

REG_DWORD

Configures the audio gateway to conserve power when the audio connection is not needed.

  • 0 = Keeps the service level connection active for the Hands-Free Profile in between calls.
  • 1 = Closes the service level connection between calls.

SpkVolume

REG_DWORD

The default speaker volume with respect to the AT+VGS command.

8

Capability

REG_DWORD

The capability bitmask that is specified by the Hands-Free profile. Optional bitmask values are:

  • 0x04 = Enable voice tag support
  • 0x08 = Enable in-band ringtone

0x21

PageTimeout

REG_DWORD

The page timeout for connecting to the peer Bluetooth device. This value is passed as a parameter to the BthWritePageTimeout function.

Extensions\1

REG_SZ

Name of the AT command extension DLL to load.

"DllName"="BTAGExt1.dll"

Extensions\2

REG_SZ

Name of the AT command extension DLL to load.

"DllName"="BTAGExt2.dll"

OutgoingCallOption

REG_DWORD

How outgoing calls should be handled.

  • 0 = Prompts where the outgoing call should be handled.
  • 1 = Automatically handles the call in the headset.
  • 2 = Disables audio routing and automatically handles the call in the hands-free device.

SniffDelay

REG_DWORD

The timeout in milliseconds before activating the SNIFF mode for the connection.

5000

SniffMax

REG_DWORD

The maximum acceptable number of Baseband slots between each sniff period.

The valid range is 0x0001 through 0xFFFF, which is equivalent to a time range of 0.625 milliseconds through 40.9 seconds.

SniffMin

REG_DWORD

The minimum acceptable number of Baseband slots between each sniff period.

The valid range is 0x0001 through 0xFFFF, which is equivalent to a time range of 0.625 milliseconds through 40.9 seconds.

SniffAttempt

REG_DWORD

The number of Baseband receive slots for sniff attempt.

The valid range is 0x0001 to 0x7FFF. The time is equal to (2 * N -1) * 0.625 msec. The valid time range is 0.625 milliseconds through 40.9 seconds.

SniffTimeout

REG_DWORD

The number of Baseband receive slots for sniff timeout.

The valid range for N is 0x0000 to 0x7FFF. For values greater than 0, the time is equal to (2 * N -1) * 0.625 msec. If N is equal to 0, then the time is equal to 0 milliseconds. The valid time range is 0 through 40.9 seconds.

NoRoleSwitch

REG_DWORD

Whether the stack can request a role switch with the peer device.

0 = Enables role switching.

1 = Disables role switching.

1

UnattendedMode

REG_DWORD

Specifies whether the device allows applications to continue to run instead of pausing them when the screen is turned off.

  • 0 = Applications do not continue to run unattended.
  • 1 = Applications continue to run unattended.

0

UseESCO

REG_DWORD

Specifies whether to use eSCO audio.

  • 0 = Disables ESCO audio.
  • 1 = Enables ESCO audio.

0

You can enable the Audio Gateway Service by using this registry entry, located in the key HKEY_LOCAL_MACHINE\Services\BTAGSVC.

Name

Type

Description

IsEnabled

REG_DWORD

Determines whether the service is started at boot time.

  • 0 = Service is not started at boot time.
  • 1 = Service is started at boot time.

See Also

Reference

Bluetooth Registry Settings
Bluetooth Audio Gateway Service Reference