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 |