structure BLUETOOTH_DEVICE_SEARCH_PARAMS (bluetoothapis.h)

Article
02/26/2024

La structure BLUETOOTH_DEVICE_SEARCH_PARAMS spécifie les critères de recherche pour les recherches d’appareils Bluetooth.

Syntaxe

typedef struct _BLUETOOTH_DEVICE_SEARCH_PARAMS {
  DWORD  dwSize;
  BOOL   fReturnAuthenticated;
  BOOL   fReturnRemembered;
  BOOL   fReturnUnknown;
  BOOL   fReturnConnected;
  BOOL   fIssueInquiry;
  UCHAR  cTimeoutMultiplier;
  HANDLE hRadio;
} BLUETOOTH_DEVICE_SEARCH_PARAMS;

Membres

dwSize

Taille de la structure en octets.

fReturnAuthenticated

Valeur qui spécifie que la recherche doit retourner des appareils Bluetooth authentifiés.

fReturnRemembered

Valeur qui spécifie que la recherche doit retourner les appareils Bluetooth mémorisés.

fReturnUnknown

Valeur qui spécifie que la recherche doit retourner des appareils Bluetooth inconnus.

fReturnConnected

Valeur qui spécifie que la recherche doit retourner des appareils Bluetooth connectés.

fIssueInquiry

Valeur qui spécifie qu’une nouvelle demande doit être émise.

cTimeoutMultiplier

Valeur qui indique le délai d’expiration de l’enquête, exprimé par incréments de 1,28 seconde. Par exemple, une requête de 12,8 secondes a une valeur cTimeoutMultiplier de 10. La valeur maximale de ce membre est 48. Lorsqu’une valeur supérieure à 48 est utilisée, la fonction appelante échoue immédiatement et retourne E_INVALIDARG.

hRadio

Poignée pour la radio sur laquelle effectuer l’enquête. Définissez la valeur NULL pour effectuer l’enquête sur toutes les radios Bluetooth locales.

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)