Bluetooth IOCTLs

La pila de controladores Bluetooth proporciona controladores de perfil con varios ICTL para recopilar información sobre:

• Radio y sistema Bluetooth local.

• Dispositivos Bluetooth remotos.

• El dispositivo que provocó que el Administrador de Plug and Play (PnP) cargara un controlador de perfil.

To gather information about the local Bluetooth radio and system, a profile driver uses IOCTL_BTH_GET_LOCAL_INFO. After the IOCTL returns, its AssociatedIrp.SystemBuffer member contains a pointer to a BTH_LOCAL_RADIO_INFO structure that contains information about the local Bluetooth radio and system, including flags that indicate whether the local radio can be discovered and connected to. The returned BTH_LOCAL_RADIO_INFO structure contains a BTH_DEVICE_INFO structure, which contains system-specific information, and a BTH_RADIO_INFO structure, which contains local radio-specific information.

To gather information about a specific remote Bluetooth device, a profile driver uses IOCTL_BTH_GET_RADIO_INFO. After the IOCTL returns, its AssociatedIrp.SystemBuffer member contains a pointer to a BTH_RADIO_INFO structure that provides information about the specific remote radio, including whether the remote radio can be discovered and connected to.

To gather information about all remote radios that have been discovered, a profile driver uses IOCTL_BTH_GET_DEVICE_INFO. After the IOCTL returns, its AssociatedIrp.SystemBuffer member contains a pointer to a BTH_DEVICE_INFO_LIST structure that contains an array of BTH_DEVICE_INFO structures. La estructura BTH_DEVICE_INFO_LIST contiene una entrada de matriz para cada radio remota detectada. The user-mode BluetoothGetDeviceInfo API uses this functionality to return information about all remote radios.

To gather information about the remote device that caused the PnP Manager to load it, a profile driver uses IOCTL_INTERNAL_BTHENUM_GET_DEVINFO. After the IOCTL returns, its AssociatedIrp.SystemBuffer member contains a pointer to a BTH_DEVICE_INFO structure that contains information about the remote device, including its Bluetooth device address, device state, and its class-of-device (CoD) settings.

A profile driver uses IOCTL_INTERNAL_BTHENUM_GET_ENUMINFO to obtain information about the underlying device and service that caused the PnP manager to load the profile driver. After the IOCTL returns, its AssociatedIrp.SystemBuffer member contains a pointer to a BTH_ENUMERATOR_INFO structure that contains vendor-provided information about the device, including the port number, device flags, vendor ID, and product ID.

Para obtener más información sobre el uso de IOCTLs y BRB de Bluetooth, consulte Compilar y enviar un BRB.