Поделиться через


функция обратного вызова PFN_DEVICE_CALLBACK (bluetoothapis.h)

Функция PFN_DEVICE_CALLBACK — это прототип обратного вызова, используемый при выборе устройств Bluetooth. Если специализированная фильтрация не требуется, функция PFN_DEVICE_CALLBACK может иметь значение NULL .

Синтаксис

PFN_DEVICE_CALLBACK PfnDeviceCallback;

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

Параметры

pvParam

Параметр, передаваемый из элемента pvParamструктуры BLUETOOTH_SELECT_DEVICE_PARAMS через функцию BluetoothSelectDevices .

pDevice

Запрашивается удаленный адрес Bluetooth; это адрес, вставленный в список устройств Bluetooth, представленный пользователем.

Возвращаемое значение

При возврате значения FALSE устройство не добавляется в представление списка устройств Bluetooth.

Комментарии

Структура BLUETOOTH_DEVICE_INFO , на которую указывает pDevice , — это устройство, которое запрашивает функция BluetoothSelectDevices , чтобы определить, следует ли добавить это устройство в представление списка.

Если обратный вызов выполняет запросы SDP для каждого устройства, список устройств, с которых пользователь может выбрать, будет отложен до тех пор, пока не будут запрошены все устройства. Рекомендуется использовать службу для вызова bitfield в классе устройства, доступного через GET_COD_SERVICE, чтобы определить, должно ли устройство отображаться для пользователя. Битовое поле класса службы доступно в параметре pDevice через член ulClassOfDevice .

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header bluetoothapis.h (включая Bthsdpdef.h, BluetoothAPIs.h)

См. также раздел

BLUETOOTH_DEVICE_INFO

BLUETOOTH_SELECT_DEVICE_PARAMS

BluetoothSelectDevices