PFN_DEVICE_CALLBACK fonction de rappel (bluetoothapis.h)

La fonction PFN_DEVICE_CALLBACK est un prototype de rappel utilisé en association avec la sélection d’appareils Bluetooth. La fonction PFN_DEVICE_CALLBACK peut être définie sur NULL si aucun filtrage spécialisé n’est requis.

Syntaxe

PFN_DEVICE_CALLBACK PfnDeviceCallback;

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

Paramètres

pvParam

Paramètre transmis à partir du membre pvParam de la structure BLUETOOTH_SELECT_DEVICE_PARAMS via la fonction BluetoothSelectDevices .

pDevice

Adresse Bluetooth distante interrogée ; il s’agit de l’adresse insérée dans la liste présentée par l’utilisateur des appareils Bluetooth.

Valeur retournée

Le retour de FALSE empêche l’ajout de l’appareil à la vue de liste des appareils Bluetooth.

Remarques

La structure BLUETOOTH_DEVICE_INFO pointée dans pDevice est l’appareil que la fonction BluetoothSelectDevices interroge pour déterminer si cet appareil doit être ajouté à l’affichage de liste.

Si le rappel effectue des requêtes SDP pour chaque appareil, la liste des appareils à partir desquels l’utilisateur peut choisir sera retardée jusqu’à ce que tous les appareils puissent être interrogés. Une approche recommandée consiste à utiliser le service pour appeler bitfield dans la classe de l’appareil, disponible via GET_COD_SERVICE, afin de déterminer si l’appareil doit être affiché à l’utilisateur. Le champ de bits de la classe de service est disponible dans le paramètre pDevice via le membre ulClassOfDevice .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h)

Voir aussi

BLUETOOTH_DEVICE_INFO

BLUETOOTH_SELECT_DEVICE_PARAMS

BluetoothSelectDevices