Bluetooth Profiles Reference
10/16/2008
This topic provides links to more information related to the API reference information for using the Bluetooth profiles that are available with Windows Embedded NavReady. It also provides links to other Bluetooth APIs that are supported for use on a Windows Embedded NavReady powered device.
In This Section
Hands-Free Profile Service Reference
Provides reference information about the API for the Hands-Free Profile (HFP). This API manages and controls paired Bluetooth-enabled phones.In Windows Embedded NavReady, programming elements in the HFP Service API that are related to Short Message Service (SMS) are not supported.
- A2DP Profile Reference
Provides reference information about APIs used by the Advanced Audio Distribution Profile (A2DP). This API allows a Windows Embedded NavReady powered device to stream advanced audio to another Bluetooth-enabled device.
Related Sections
- Bluetooth Pairing Service Reference
Describes the programming elements in the Bluetooth Pairing Service, which provides Bluetooth pairing management functionality to applications requiring access to paired devices.
WODM_OPEN_CLOSE_A2DP
This message is used to connect or disconnect an existing connection to a paired device that supports A2DP. It is used in an MMDRV_MESSAGE_PARAMS structure passed to the WAVIOControl function.You can use this message to either connect with a paired device that supports A2DP, or to close an existing A2DP connection.
This message is supported by Windows Embedded NavReady.
WODM_BT_SCO_AUDIO_CONTROL
This message is used to route audio to the Bluetooth hardware. It is used in an MMDRV_MESSAGE_PARAMS structure passed to the WAVIOControl function.This message is supported by Windows Embedded NavReady.
In this message, dwParam1 indicates the type of SCO audio to be routed. It can be one of the following values:
Value Description 0
Enables Audio Gateway (AG) audio (from Bluetooth to cellular phone)
1
Enables hands-free audio (from Bluetooth to microphone/speakers)
10
Mutes the hands-free microphone
11
Enables or disables Acoustic Echo Cancellation (AEC)
AVCOpCodes
This enumeration lists the supported Bluetooth unit and Bluetooth sub-unit commands. It contains values that can be used in the OpCode member of AvrcpMsg.This enumeration can be used for AVRCP and is supported by Windows Embedded NavReady.
For more information, see %_WINCEROOT%\PUBLIC\COMMON\OAK\INC\bt_avrcp.h.
AvrcpMsg
This structure specifies the ID and type of a specific AVRCP message.After the controller (CT) device sends a command over a Bluetooth link, the AVRCP profile on the Windows Embedded NavReady powered device reads a packet from the Bluetooth stack. This packet is formatted according to the 1394ta specification and is translated into an AvrcpMsg structure, which is written to a message queue.
You must create a message queue to read the AvrcpMsg structure when it arrives from the AVRCP profile. Then, you can handle the message appropriately. For more information, see Message Queue Point-to-Point.
There is no response message required by the CT device that sent the command.
The opCode member can be used by a message handler to handle the AvrcpMsg structure and provide the appropriate functionality. If opCode is set to PassThru_t, then the opId parameter contains a PassThruOpId value that indicates the command.
The opId member indicates the ID of a command, such as Play_t, Stop_t, Pause_t, FastFwd_t, Rewind_t, Forward_t, or Backward_t. Possible values for opId are provided in the PassThruOpId enumeration.
This structure is supported by Windows Embedded NavReady.
For more information, see %_WINCEROOT%\PUBLIC\COMMON\OAK\INC\bt_avrcp.h.
PassThruOpId
This enumeration specifies AVRCP pass-through commands that are used by the opID parameter of the AvrcpMsg structure.This enumeration is supported by Windows Embedded NavReady.
For more information, see %_WINCEROOT%\PUBLIC\COMMON\OAK\INC\bt_avrcp.h.
See Also
Reference
Concepts
Overview of Audio/Video Remote Control Profile (AVRCP) (Target Role)
Overview of Advanced Audio Distribution Profile (A2DP) (Source Role)
Bluetooth Profiles OS Design Development