IOCTL_INTERNAL_BTH_SUBMIT_BRB IOCTL (bthioctl.h)
Profile drivers use IOCTL_INTERNAL_BTH_SUBMIT_BRB to submit a Bluetooth Request Block (BRB) to the Bluetooth driver stack.
Major code
IRP_MJ_INTERNAL_DEVICE_CONTROL
Input buffer
The Parameters.Others.Argument1 member points to the address an instance of the structure that corresponds to the BRB that the profile driver intends to issue. The following list describes the structures that correspond to specific BRBs.
| Bluetooth Request Block (BRB) | Corresponding structure |
|---|---|
| BRB_HCI_GET_LOCAL_BD_ADDR | |
| BRB_L2CA_REGISTER_SERVER | |
| BRB_L2CA_UNREGISTER_SERVER | _BRB_L2CA_UNREGISTER_SERVER |
| BRB_L2CA_OPEN_CHANNEL | |
| BRB_L2CA_OPEN_CHANNEL_RESPONSE | |
| BRB_L2CA_CLOSE_CHANNEL | |
| BRB_L2CA_ACL_TRANSFER | |
| BRB_L2CA_UPDATE_CHANNEL | |
| BRB_L2CA_PING | |
| BRB_REGISTER_PSM | |
| BRB_UNREGISTER_PSM | |
| BRB_SCO_REGISTER_SERVER | |
| BRB_SCO_UNREGISTER_SERVER | |
| BRB_SCO_OPEN_CHANNEL | |
| BRB_SCO_OPEN_CHANNEL_RESPONSE | |
| BRB_SCO_CLOSE_CHANNEL | |
| BRB_SCO_TRANSFER | |
| BRB_SCO_GET_CHANNEL_INFO | |
| BRB_SCO_GET_SYSTEM_INFO | |
| BRB_SCO_FLUSH_CHANNEL | |
| BRB_ACL_GET_MODE | |
| BRB_ACL_ENTER_ACTIVE_MODE | |
| BRB_GET_DEVICE_INTERFACE_STRING | _BRB_GET_DEVICE_INTERFACE_STRING |
Input buffer length
The length of the structure.
Output buffer
If the BRB returns output, Parameters->Others.Argument1 points to the same BRB that was passed as input. Output is returned in the members of the associated BRB structure or in buffers that are specified in the BRB structure.
Output buffer length
The length of the structure
Status block
If the request is successful, the Information member of the STATUS_BLOCK structure is set to the size, in bytes, of the Bluetooth request block that was submitted. Otherwise, the Information member is set to zero.
The Status member is set to one of the values in the following table.
| Status value | Description |
|---|---|
| STATUS_SUCCESS | The IOCTL completed successfully. |
| STATUS_INVALID_DEVICE_REQUEST | The request sent to the remote device through the BRB structure was invalid. |
| STATUS_INVALID_PARAMETER | One or more of the input parameters was invalid. |
|
The length of the supplied buffer was too small. |
| STATUS_NOT_IMPLEMENTED | The stack has not implemented the necessary module to process the BRB. |
| STATUS_NOT_SUPPORTED | The stack does not support this BRB. |
| STATUS_PENDING | The BRB is pending. |
Remarks
Profile drivers use BRBs to handle most input, output, and connection tasks. A number of BRBs are defined for these tasks, and each one uses a specific, corresponding structure. All BRBs share a common header, which contains the type of the BRB. The Bluetooth driver stack uses the BRB header to correctly interpret the remainder of the BRB. For more information about BRB headers, see the BRB_HEADER structure.
For more information about how profile drivers use BRBs to communicate with the Bluetooth driver stack, see Building and Sending a BRB.
These BRBs must be called at IRQL <= PASSIVE_LEVEL.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Versions:_Supported in Windows Vista, and later. |
| Header | bthioctl.h (include BthIoctl.h) |
| IRQL | <= PASSIVE_LEVEL |