BthReadLocalVersion (Compact 2013)

  • Article

3/26/2014

This function reads the version and capabilities of Host Controller Interface (HCI) and Link Manager Protocol (LMP) layers on the local device.

Syntax

int BthReadLocalVersion(
  unsigned char *phci_version,
  unsigned short *phci_revision,
  unsigned char *plmp_version,
  unsigned short *plmp_subversion,
  unsigned short *pmanufacturer,
  unsigned char *plmp_features
);

Parameters

For more information about the output parameters, see the Core Specification v2.1 + EDR on the Bluetooth website.

Return Value

The following table shows the possible return values.

Value

Description

ERROR_SUCCESS

Success.

ERROR_SERVICE_NOT_ACTIVE

The Bluetooth stack is not present.

Other standard HRESULT error codes may be returned as appropriate.

Remarks

This function is a combination of the following HCI commands.

  • Read_Local_Version_Information
  • Read_Local_Supported_Features

Note

To preserve Microsoft Win32 compatibility, consider using the Winsock equivalent of this function. To do so, set the optname parameter in the getsockopt function to SO_BTH_GET_LOCAL_VER.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions
Bluetooth AG Service Functions