HCI IOCTL Functions

The following table shows all the host controller interface (HCI) IOCTLs.

HCI IOCTL Description
BTH_HCI_IOCTL_GET_BD_FOR_HANDLE Retrieves the address of a peer Bluetooth-based device for connection handle.
BTH_HCI_IOCTL_GET_HANDLE_FOR_BD Retrieves the connection handle for a Bluetooth device if it is connected.
BTH_HCI_IOCTL_GET_NUM_UNSENT Retrieves the number of packets pending before being sent to the card.
BTH_HCI_IOCTL_GET_NUM_ONDEVICE Retrieves the number of unconfirmed packets sent to the hardware.
BTH_HCI_IOCTL_GET_NUM_PENDING Retrieves the number of confirmed and pending packets that are in execution on the hardware.
BTH_HCI_IOCTL_GET_INQUIRY Retrieves the inquiry status.
BTH_HCI_IOCTL_GET_PERIODIC_INQUIRY Retrieves periodic inquiry status.
BTH_HCI_IOCTL_GET_LOOPBACK Retrieves the loopback status.
BTH_HCI_IOCTL_GET_ERRORS Retrieves the number of hardware errors.
BTH_HCI_IOCTL_GET_FLOW Retrieves host flow control status.
BTH_HCI_IOCTL_GET_COMMANDSIZE Retrieves the loopback status.
BTH_HCI_IOCTL_HANDLE_AUTHENTICATED Retrieves the authentication status of the connection.
BTH_HCI_IOCTL_HANDLE_ENCRYPTED Retrieves encryption status of the connection.
BTH_HCI_IOCTL_GET_UNDER_TEST Retrieves the hardware testing state.
BTH_HCI_IOCTL_GET_LAST_INQUIRY_DATA Retrieves the inquiry parameters from the cache for a particular device.
BTH_HCI_IOCTL_GET_BASEBAND_HANDLES Retrieves baseband connections that are currently active.
BTH_HCI_IOCTL_GET_HANDLE_MODE Retrieves the mode for active baseband connections.
BTH_HCI_IOCTL_GET_HARDWARE_STATUS Retrieves the current state of the hardware, whether the card is in or out of the Bluetooth stack.
BTH_STACK_IOCTL_GET_CONNECTED Retrieves the state of the hardware.

Adding new IOCTL functions

New services can be provided by the extension layer through the standard stream driver IOControl mechanism. Applications can access these new services through the new IOCTL calls.

The following illustrates how to add new IOCTL functions.

int iRes = DeviceIoControl (
   hFile, LAYER_IOCTL_SERVICE_1, 
   &p, sizeof(p), NULL, 0, NULL, NULL
);

See Also

Establishing Connections through HCI | Enhancing the Bluetooth Stack

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.