PFN_DEVICE_CALLBACK Rückruffunktion (bluetoothapis.h)

Artikel
02/26/2024

Die funktion PFN_DEVICE_CALLBACK ist ein Rückrufprototyp, der in Verbindung mit der Auswahl von Bluetooth-Geräten verwendet wird. Die funktion PFN_DEVICE_CALLBACK kann auf NULL festgelegt werden, wenn keine spezielle Filterung erforderlich ist.

Syntax

PFN_DEVICE_CALLBACK PfnDeviceCallback;

BOOL PfnDeviceCallback(
  LPVOID pvParam,
  const BLUETOOTH_DEVICE_INFO *pDevice
)
{...}

Parameter

pvParam

Ein Parameter, der vom pvParam-Element der BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur über die BluetoothSelectDevices-Funktion übergeben wird.

pDevice

Abgefragte Bluetooth-Remoteadresse; Dies ist die Adresse, die in die vom Benutzer angezeigte Liste der Bluetooth-Geräte eingefügt wird.

Rückgabewert

Die Rückgabe von FALSE verhindert, dass das Gerät der Listenansicht von Bluetooth-Geräten hinzugefügt wird.

Hinweise

Die BLUETOOTH_DEVICE_INFO Struktur, auf die in pDevice verwiesen wird, ist das Gerät, das die BluetoothSelectDevices-Funktion abfragt , um zu bestimmen, ob dieses Gerät der Listenansicht hinzugefügt werden soll.

Wenn der Rückruf SDP-Abfragen für jedes Gerät ausführt, wird die Liste der Geräte, von denen der Benutzer auswählen kann, verzögert, bis alle Geräte abgefragt werden können. Ein empfohlener Ansatz ist die Verwendung des Diensts zum Aufrufen des Bitfelds in der Geräteklasse, die über GET_COD_SERVICE verfügbar ist, um zu bestimmen, ob das Gerät dem Benutzer angezeigt werden soll. Das Bitfeld der Dienstklasse ist im pDevice-Parameter über den ulClassOfDevice-Member verfügbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)

Weitere Informationen

BLUETOOTH_DEVICE_INFO

BLUETOOTH_SELECT_DEVICE_PARAMS

BluetoothSelectGeräte

Share via