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) |