BTH_HCI_IOCTL_GET_HARDWARE_STATUS (Windows CE 5.0)
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
OS Versions: Windows CE.NET 4.2 and later.
Header: Bt_ddi.h
Send Feedback on this topic to the authors