BthGetHardwareStatus

This function obtains the hardware status.

Note    If you must use this operation, then use it with extreme caution. If the Bluetooth controller is inactive, such as when it is removed or turned off, then this operation forces enumeration of present hardware as if the controller were inserted, and is therefore expensive in terms of time and resources.

int BthGetHardwareStatus(
  int* pistatus
);

Parameters

• pistatus
  [out] Pointer to an integer that returns the hardware status. The following table shows the possible values.

  Value	Description
  HCI_HARDWARE_UNKNOWN	The stack is not present.
  HCI_HARDWARE_RUNNING	The adapter is installed and the stack is running.
  HCI_HARDWARE_INITIALIZING	The adapter might be installed. The stack is currently on the way up. Call again later.
  HCI_HARDWARE_ERROR	The adapter might be installed. The stack is on the way down. Call again later.
  HCI_HARDWARE_SHUTDOWN	The adapter is installed, but the stack is not running.
  HCI_HARDWARE_NOT_PRESENT	The adapter is not present.

Return Values

This function returns ERROR_SUCCESS when it completes successfully.

A return value of ERROR_SERVICE_NOT_ACTIVE indicates that the hardware is not inserted or that the Bluetooth stack is not present.

Other standard error codes may be returned as appropriate.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Bt_api.h.
Link Library: Btdrt.lib.

See Also

Bluetooth Platform Development Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.