Share via


IOCTL_AG_CLOSE_AUDIO (Compact 2013)

3/26/2014

This I/O control message closes the currently open audio connection to the hands-free device. Send this message with DeviceIoControl.

Syntax

BOOL DeviceIoControl(
    HANDLE hDevice,           // handle to device
    DWORD dwIoControlCode,    // use IOCTL_AG_CLOSE_AUDIO
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned,  // number of bytes returned
    OVERLAPPED lpOverlapped   // pointer to OVERLAPPED structure
);

Parameters

  • hDevice
    The handle to the device.
  • dwIoControlCode
    [in] Control code for the operation. Use IOCTL_AG_CLOSE_AUDIO for this operation.
  • lpInBuffer
    [in] Not used; set to NULL.
  • nInBufferSize
    [in] Not used; set to zero.
  • lpOutBuffer
    [out] Not used; set to NULL.
  • nOutBufferSize
    [out] Not used; set to zero.
  • lpBytesReturned
    [out] Not used; set to NULL.
  • lpOverlapped
    [out] Not used; set to NULL.

Remarks

Note

IOCTL_AG_CLOSE_AUDIO does not close the currently open service level connection. To close it, use IOCTL_AG_CLOSE_CONTROL.

This I/O control sends the WODM_BT_SCO_AUDIO_CONTROL message to the audio driver to disable audio routing. Other AG service I/O controls do not communicate with the audio driver.

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. To open an audio connection to the hands-free device, use the IOCTL_AG_OPEN_AUDIO I/O control.

Requirements

Header

btagpub.h

See Also

Reference

Bluetooth AG Service IOCTL Messages