IOCTL_BTH_GET_DEVICE_INFO IOCTL (bthioctl.h)

Die IOCTL_BTH_GET_DEVICE_INFO-Anforderung gibt Informationen zu allen zwischengespeicherten, zuvor ermittelten Remoteradios zurück, die Bluetooth-fähig sind.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der AssociatedIrp.SystemBuffer-Member verweist auf einen Puffer für eine BTH_DEVICE_INFO_LIST-Struktur .

Länge des Eingabepuffers

Die Länge einer BTH_DEVICE_INFO_LIST-Struktur

Ausgabepuffer

Der AssociatedIrp.SystemBuffer-Member zeigt auf einen Puffer, der eine BTH_DEVICE_INFO_LIST-Struktur enthält. Der numOfDevices-Member der BTH_DEVICE_INFO_LIST-Struktur enthält die Anzahl der Geräte, für die Informationen vorhanden sind, sowie ein Array von BTH_DEVICE_INFO Strukturen. Ein Arrayeintrag für jedes Gerät.

Länge des Ausgabepuffers

Wenn die Größe des übergebenen Ausgabepuffers nicht genau sizeof(BTH_DEVICE_INFO_LIST) plus dem richtigen Vielfachen von sizeof(BTH_DEVICE_INFO)ist, schlägt die Anforderung mit STATUS_INVALID_BUFFER_SIZE fehl.

Statusblock

Wenn die Anforderung erfolgreich ist, wird der Information-Member der STATUS_BLOCK-Struktur auf die Größe des Puffers in Bytes festgelegt, der Informationen über das Array von Geräten enthält. Die BTH_DEVICE_INFO_LIST-Struktur enthält Speicher für die erste BTH_DEVICE_INFO-Struktur. Wenn also keine Geräte zurückgegeben werden, wird der Information-Member auf die Größe der ersten Struktur festgelegt.

Das Status-Element wird auf einen der Werte in der folgenden Tabelle festgelegt.

Statuswert	BESCHREIBUNG
STATUS_SUCCESS	Die IOCTL wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER	Der übergebene Eingabepuffer war NULL.
STATUS_INVALID_BUFFER_SIZE	Die Größe des Ausgabepuffers war nicht richtig.

Hinweise

Die IOCTL_BTH_GET_DEVICE_INFO IOCTL bietet Informationen zu allen zuvor ermittelten Remoteradios.

Der numOfDevices-Member der BTH_DEVICE_INFO_LIST-Struktur gibt die Gesamtzahl der BTH_DEVICE_INFO-Strukturen zurück, die von der IOCTL zurückgegeben werden. Wenn der aufrufende Treiber einen Puffer übergibt, der kleiner als der Wert des numOfDevices-Elements ist, wird nur ein Teil der verfügbaren Strukturen zurückgegeben. Bluetooth-Treiberentwickler sollten zuerst IOCTL_BTH_GET_DEVICE_INFO mit einem kleinen Puffer aufrufen, z. B sizeof(BTH_DEVICE_INFO_LIST). , und dann den zurückgegebenen numOfDevices-Member verwenden, um den Puffer für einen nachfolgenden Aufruf richtig zu dimensionieren.

Die BTH_DEVICE_INFO_LIST-Struktur enthält Speicher für die erste BTH_DEVICE_INFO-Struktur. Verwenden Sie die folgende Formel, um die richtige Puffergröße für einen Aufruf von IOCTL_BTH_GET_DEVICE_INFO zu berechnen: Buffer=sizeof(BTH_DEVICE_INFO_LIST)+(NumOfDevices-1)*sizeof(BTH_DEVICE_INFO).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Kopfzeile	bthioctl.h (einschließlich Bthioctl.h)
IRQL	<= PASSIVE_LEVEL

Weitere Informationen

BTH_DEVICE_INFO

BTH_DEVICE_INFO_LIST