IOCTL_BTHX_GET_VERSION IOCTL (bthxddi.h)
Profiltreiber verwenden IOCTL_BTHX_GET_VERSION, um die vom Transporttreiber unterstützte Version abzurufen.
Hauptcode
Eingabepuffer
Keine.
Länge des Eingabepuffers
Keine.
Ausgabepuffer
Profiltreiber sollten KMDF und die zugehörige WdfRequestRetrieveOutputMemory-Methode verwenden, um Ausgabeparameter abzurufen. So rufen Sie beispielsweise den Ausgabepuffer ab:
Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);
Der Puffer beschreibt eine BTHX_VERSION-Struktur .
Weitere Informationen finden Sie in den WDK-Bluetooth-Beispielen.
Länge des Ausgabepuffers
Die Länge des Puffers entspricht der Größe der BTHX_VERSION-Struktur .
Statusblock
Der Information-Member der STATUS_BLOCK-Struktur wird auf die Größe des Puffers in Bytes festgelegt, der die BTHX_VERSION-Struktur enthält.
Das Status-Element wird auf einen der Werte in der folgenden Tabelle festgelegt.
Statuswert | BESCHREIBUNG |
---|---|
STATUS_SUCCESS | Die IOCTL wurde erfolgreich abgeschlossen. |
Jeder nicht erfolgreiche NT-status-Code verhindert das Laden des Treibers.
Hinweise
IOCTL_BTHX_GET_VERSION ist ein synchroner Vorgang.
Ein Transporttreiber kann eine oder mehrere Versionen zurückgeben, die er in BTHX_VERSION-Struktur unterstützt. Wenn keine Version festgelegt ist, entlädt Windows den Bluetooth-Stapel.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Unterstützt ab Windows 8. |
Kopfzeile | bthxddi.h |
IRQL | <= PASSIVE_LEVEL |