structure BLUETOOTH_SELECT_DEVICE_PARAMS (bluetoothapis.h)

Article
03/01/2024

La structure BLUETOOTH_SELECT_DEVICE_PARAMS facilite et gère la visibilité, l’authentification et la sélection des appareils et services Bluetooth.

Syntaxe

typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
  DWORD                  dwSize;
  ULONG                  cNumOfClasses;
  BLUETOOTH_COD_PAIRS    *prgClassOfDevices;
  LPWSTR                 pszInfo;
  HWND                   hwndParent;
  BOOL                   fForceAuthentication;
  BOOL                   fShowAuthenticated;
  BOOL                   fShowRemembered;
  BOOL                   fShowUnknown;
  BOOL                   fAddNewDeviceWizard;
  BOOL                   fSkipServicesPage;
  PFN_DEVICE_CALLBACK    pfnDeviceCallback;
  LPVOID                 pvParam;
  DWORD                  cNumDevices;
  PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;

Membres

dwSize

Taille, en octets, de la structure BLUETOOTH_SELECT_DEVICE_PARAMS .

cNumOfClasses

Nombre de classes dans prgClassOfDevices. Définissez sur zéro pour rechercher tous les appareils.

prgClassOfDevices

Tableau de la classe d’appareils à rechercher.

pszInfo

Définit le texte d’informations lorsqu’il n’est pas NULL.

hwndParent

Handle vers la fenêtre parente. Définissez sur NULL pour aucun parent.

fForceAuthentication

Si la valeur EST TRUE, force l’authentification avant le retour.

fShowAuthenticated

Si la valeur EST TRUE, les appareils authentifiés s’affichent dans le sélecteur.

fShowRemembered

Si la valeur EST TRUE, les appareils mémorisés sont affichés dans le sélecteur.

fShowUnknown

Si la valeur est TRUE, les appareils inconnus qui ne sont pas authentifiés ou mémorisés sont affichés dans le sélecteur.

fAddNewDeviceWizard

Si la valeur est TRUE, démarre l’Assistant Ajouter un nouvel appareil.

fSkipServicesPage

Si la valeur est TRUE, ignore la page Services dans l’Assistant Ajouter un nouvel appareil.

pfnDeviceCallback

Pointeur vers une fonction de rappel appelée pour chaque appareil. Si la fonction de rappel retourne TRUE, l’élément est ajouté. Si la fonction de rappel retourne FALSE, l’élément n’est pas affiché. Définissez pfnDeviceCallback sur null pour aucun rappel. Pour plus d’informations, consultez PFN_DEVICE_CALLBACK.

pvParam

Paramètre à passer en tant que pvParam à la fonction de rappel pointée dans pfnDeviceCallback.

cNumDevices

En entrée, spécifie le nombre d’appels souhaités. Définissez sur zéro pour aucune limite. À la sortie, retourne le nombre d’appareils retournés.

pDevices

Pointeur vers un tableau de structures BLUETOOTH_DEVICE_INFO .

Remarques

Pour libérer le tableau de structures BLUETOOTH_DEVICE_INFO passées dans le membre pDevices , appelez la fonction BluetoothSelectDevicesFree .

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
En-tête	bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h)

Voir aussi

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectDevices

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK

Partager via