IOCTL_BTHX_WRITE_HCI IOCTL (bthxddi.h)
IOCTL_BTHX_WRITE_HCI viene usato per scrivere dati e comandi ACL Bluetooth nel livello di trasporto.
Codice principale
Buffer di input
I driver di profilo devono usare KMDF e il relativo metodo WdfRequestRetrieveInputMemory per recuperare i parametri di input. Ad esempio, per ottenere il buffer di input:
Status = WdfRequestRetrieveInputMemory(_Request, &ReqInMemory);
Il buffer descrive una struttura BTHX_HCI_READ_WRITE_CONTEXT che specifica il tipo di scrittura e i dati associati alla scrittura.
Per altre informazioni, vedere gli esempi di Bluetooth WDK.
Lunghezza del buffer di input
La lunghezza del buffer è la dimensione della struttura BTHX_HCI_READ_WRITE_CONTEXT.
Buffer di output
I driver di profilo devono usare KMDF e il relativo metodo WdfRequestRetrieveOutputMemory per recuperare i parametri di input. Ad esempio, per ottenere il buffer di output:
Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);
Il buffer descrive una ULONG del numero di byte scritti per i dati di input specificati nella struttura BTHX_HCI_READ_WRITE_CONTEXT.
Per altre informazioni, vedere gli esempi di Bluetooth WDK.
Lunghezza del buffer di output
La lunghezza del buffer è la dimensione di una ULONG.
Blocco di stato
Se la richiesta ha esito positivo, il membro information della struttura STATUS_BLOCK viene impostato sul numero di byte nel parametro di output.
Il membro Status è impostato su uno dei valori della tabella seguente.
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | L'IOCTL è stato completato correttamente. |
Osservazioni
Lo stack Bluetooth invia IOCTL_BTHX_WRITE_HCI per scrivere i dati ACL HCI e il comando HCI al controller.
Il buffer di input punta a una struttura di BTHX_HCI_READ_WRITE_CONTEXT il cui membro DataLen specifica il numero di byte nel membro data. Il membro type è impostato in base al fatto che il pacchetto sia un pacchetto di comando o un pacchetto di dati ACL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 8. |
| intestazione | bthxddi.h |
| IRQL | <= DISPATCH_LEVEL |