IOCTL_INTERNAL_BTH_SUBMIT_BRB IOCTL (bthioctl.h)
Los controladores de perfil usan IOCTL_INTERNAL_BTH_SUBMIT_BRB para enviar un bloque de solicitudes Bluetooth (BRB) a la pila de controladores Bluetooth.
Código principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Búfer de entrada
El miembro Parameters.Others.Argument1 apunta a la dirección de una instancia de la estructura que corresponde al BRB que el controlador de perfil pretende emitir. En la lista siguiente se describen las estructuras que corresponden a brB específicos.
| Bloque de solicitud Bluetooth (BRB) | Estructura correspondiente |
|---|---|
| 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 |
Longitud del búfer de entrada
Longitud de la estructura.
Búfer de salida
Si el BRB devuelve la salida, Parameters-Others.Argument1> apunta al mismo BRB que se pasó como entrada. La salida se devuelve en los miembros de la estructura BRB asociada o en los búferes especificados en la estructura BRB.
Longitud del búfer de salida
Longitud de la estructura
Bloque de estado
Si la solicitud se realiza correctamente, el miembro Information de la estructura de STATUS_BLOCK se establece en el tamaño, en bytes, del bloque de solicitud Bluetooth que se envió. De lo contrario, el miembro Information se establece en cero.
El miembro Status se establece en uno de los valores de la tabla siguiente.
| Valor de estado | Descripción |
|---|---|
| STATUS_SUCCESS | El IOCTL se completó correctamente. |
| STATUS_INVALID_DEVICE_REQUEST | La solicitud enviada al dispositivo remoto a través de la estructura BRB no era válida. |
| STATUS_INVALID_PARAMETER | Uno o varios de los parámetros de entrada no eran válidos. |
|
La longitud del búfer proporcionado era demasiado pequeña. |
| STATUS_NOT_IMPLEMENTED | La pila no ha implementado el módulo necesario para procesar el BRB. |
| STATUS_NOT_SUPPORTED | La pila no admite este BRB. |
| STATUS_PENDING | El BRB está pendiente. |
Comentarios
Los controladores de perfil usan BRB para controlar la mayoría de las tareas de entrada, salida y conexión. Se definen varios BRB para estas tareas y cada uno usa una estructura específica y correspondiente. Todos los BRB comparten un encabezado común, que contiene el tipo de BRB. La pila del controlador Bluetooth usa el encabezado BRB para interpretar correctamente el resto del BRB. Para obtener más información sobre los encabezados BRB, vea la estructura BRB_HEADER .
Para obtener más información sobre cómo los controladores de perfil usan BRB para comunicarse con la pila de controladores Bluetooth, consulta Building and Sending a BRB.
Se debe llamar a estos BRB en IRQL <= PASSIVE_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Versions:_Supported en Windows Vista y versiones posteriores. |
| Encabezado | bthioctl.h (incluya BthIoctl.h) |
| IRQL | <= PASSIVE_LEVEL |