Share via


IOCTL_AG_OPEN_AUDIO

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This IOCTL opens a service level connection and an audio connection to the headset or the hands-free device.

Parameters

  • hDeviceContext
    [in] Device context handle.
  • fSelector
    [in] Equals IOCTL_AG_OPEN_AUDIO.
  • cInBuffer
    Not used.
  • pInBuffer
    Not used.
  • cOutBuffer
    Not used.
  • pOutBuffer
    Not used.
  • pcDataReturned
    Not used.

Return Values

Returns TRUE if successful, FALSE otherwise. To obtain extended error information, call the GetLastError function.

Remarks

To close an audio connection to the headset, use the IOCTL_AG_CLOSE_AUDIO IOCTL.

To route audio to the headset or to the hands-free device independent of the Network Component, you must first open or close an audio connection.

OEM Extensibility Considerations

To route audio to the Bluetooth hardware outside the call context, the application can send IOCTL_AG_OPEN_AUDIO to the AG service. The AG service automatically sends the WODM_BT_SCO_AUDIO_CONTROL message to the audio driver when an incoming call is answered by the hands-free device and outgoing calls are placed with the phone connected to the hands-free device.

Requirements

Header btagpub.h
Windows Embedded CE Windows CE 5.0 and later

See Also

Concepts

Audio Gateway Core Component