BTH_HCI_IOCTL_GET_HARDWARE_STATUS

  • Article

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

OS Versions: Windows CE .NET 4.2 and later.
Header: Bt_ddi.h

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.