BthGetHardwareStatus (Compact 2013)

3/26/2014

This function obtains the hardware status.

Syntax

int BthGetHardwareStatus(
  int *pistatus
);

Parameters

  • pistatus
    [out] Pointer to the hardware status.

    The following table shows the possible values.

    Value

    Description

    HCI_HARDWARE_UNKNOWN

    The stack is not present.

    HCI_HARDWARE_RUNNING

    The controller is installed and the stack is running.

    HCI_HARDWARE_INITIALIZING

    The controller might be installed.

    The stack is currently on the way up. Call again later.

    HCI_HARDWARE_ERROR

    The controller might be installed.

    The stack is on the way down. Call again later.

    HCI_HARDWARE_SHUTDOWN

    The controller is installed, but the stack is not running.

    HCI_HARDWARE_NOT_PRESENT

    The controller is not present.

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.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions
Bluetooth AG Service Functions