IOCTL_BTHX_GET_VERSION IOCTL (bthxddi.h)

Profiltreiber verwenden IOCTL_BTHX_GET_VERSION, um die vom Transporttreiber unterstützte Version abzurufen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

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