IOCTL_BTHX_WRITE_HCI IOCTL (bthxddi.h)
IOCTL_BTHX_WRITE_HCI wird verwendet, um Bluetooth-ACL-Daten und -Befehle auf die Transportschicht zu schreiben.
Hauptcode
Eingabepuffer
Profiltreiber sollten KMDF und die zugehörige WdfRequestRetrieveInputMemory-Methode verwenden, um Eingabeparameter abzurufen. So rufen Sie beispielsweise den Eingabepuffer ab:
Status = WdfRequestRetrieveInputMemory(_Request, &ReqInMemory);
Der Puffer beschreibt eine BTHX_HCI_READ_WRITE_CONTEXT-Struktur , die den Schreibtyp und die dem Schreibvorgang zugeordneten Daten angibt.
Weitere Informationen finden Sie in den WDK-Bluetooth-Beispielen.
Eingabepufferlänge
Die Länge des Puffers entspricht der Größe der BTHX_HCI_READ_WRITE_CONTEXT Struktur.
Ausgabepuffer
Profiltreiber sollten KMDF und die zugehörige WdfRequestRetrieveOutputMemory-Methode verwenden, um Eingabeparameter abzurufen. So rufen Sie beispielsweise den Ausgabepuffer ab:
Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);
Der Puffer beschreibt eine ULONG der Anzahl von Bytes, die für die eingabedaten geschrieben werden, die in der BTHX_HCI_READ_WRITE_CONTEXT-Struktur angegeben sind.
Weitere Informationen finden Sie in den WDK-Bluetooth-Beispielen.
Länge des Ausgabepuffers
Die Länge des Puffers entspricht der Größe eines ULONG.
Statusblock
Wenn die Anforderung erfolgreich ist, wird der Information-Member der STATUS_BLOCK-Struktur auf die Anzahl der Bytes im Ausgabeparameter festgelegt.
Das Statuselement ist auf einen der Werte in der folgenden Tabelle festgelegt.
| Statuswert | BESCHREIBUNG |
|---|---|
| STATUS_SUCCESS | Das IOCTL wurde erfolgreich abgeschlossen. |
Hinweise
Der Bluetooth-Stapel sendet IOCTL_BTHX_WRITE_HCI, um HCI-ACL-Daten und den HCI-Befehl an den Controller zu schreiben.
Der Eingabepuffer verweist auf eine BTHX_HCI_READ_WRITE_CONTEXT-Struktur, deren DataLen-Member die Anzahl der Bytes im Datenmember angibt. Das Type-Element wird basierend darauf festgelegt, ob es sich bei dem Paket um ein Befehlspaket oder ein ACL-Datenpaket handelt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 8 unterstützt. |
| Kopfzeile | bthxddi.h |
| IRQL | <= DISPATCH_LEVEL |