Share via


BTH_HCI_IOCTL_GET_HARDWARE_STATUS (Windows Embedded CE 6.0)

1/6/2010

This IOCTL retrieves the current state of the hardware, whether the card is in or out of the Bluetooth stack.

Parameters

  • hDeviceContext
    [in] Device context handle.
  • fSelector
    [in] Equals BTH_HCI_IOCTL_GET_HARDWARE_STATUS.
  • cInBuffer
    [in] Equals 2.
  • pInBuffer
    [in] Contains an aligned pointer to an unsigned short containing a connection handle.
  • cOutBuffer
    [in] Size, in bytes, of the buffer.
  • pOutBuffer
    [out] Equals one of the values in the following table.

    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 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.

  • pcDataReturned
    [out] Equals cOutBuffer.

Return Values

If the call succeeds, the return value is ERROR_SUCCESS.

The following table shows a list of possible error values that will be returned if the function fails.

Error value Description

ERROR_CONNECTION_INVALID

The connection does not exist.

ERROR_INVALID_PARAMETER

Parameters are invalid (buffers are not properly sized).

ERROR_SERVICE_NOT_ACTIVE

HCI is not active or there is no hardware.

Requirements

Header bt_ddi.h
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Bluetooth Stack Extension Layer IOCTLs