IOCTL_BTHX_WRITE_HCI IOCTL (bthxddi.h)
IOCTL_BTHX_WRITE_HCI se usa para escribir datos y comandos de ACL de Bluetooth en la capa de transporte.
Código principal
Búfer de entrada
Los controladores de perfil deben usar KMDF y su método WdfRequestRetrieveInputMemory para recuperar parámetros de entrada. Por ejemplo, para obtener el búfer de entrada:
Status = WdfRequestRetrieveInputMemory(_Request, &ReqInMemory);
El búfer describe una estructura de BTHX_HCI_READ_WRITE_CONTEXT que especifica el tipo de escritura y los datos asociados a la escritura.
Consulte los ejemplos de Bluetooth de WDK para obtener más información.
Longitud del búfer de entrada
La longitud del búfer es el tamaño de la estructura BTHX_HCI_READ_WRITE_CONTEXT .
Búfer de salida
Los controladores de perfil deben usar KMDF y su método WdfRequestRetrieveOutputMemory para recuperar parámetros de entrada. Por ejemplo, para obtener el búfer de salida:
Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);
El búfer describe un ULONG del número de bytes escritos para los datos de entrada especificados en la estructura BTHX_HCI_READ_WRITE_CONTEXT .
Consulte los ejemplos de Bluetooth de WDK para obtener más información.
Longitud del búfer de salida
La longitud del búfer es el tamaño de un ULONG.
Bloque de estado
Si la solicitud se realiza correctamente, el miembro Information de la estructura STATUS_BLOCK se establece en el número de bytes del parámetro de salida.
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. |
Comentarios
La pila bluetooth envía IOCTL_BTHX_WRITE_HCI para escribir datos de ACL de HCI y el comando HCI en el controlador.
El búfer de entrada apunta a una estructura de BTHX_HCI_READ_WRITE_CONTEXT cuyo miembro DataLen especifica el número de bytes del miembro Data . El miembro Type se establece en función de si el paquete es un paquete de comandos o un paquete de datos de ACL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 8. |
| Encabezado | bthxddi.h |
| IRQL | <= DISPATCH_LEVEL |