Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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