PFN_DEVICE_CALLBACK callback function

The PFN_DEVICE_CALLBACK function is a callback prototype used in association with selecting Bluetooth devices. The PFN_DEVICE_CALLBACK function can be set to NULL if no specialized filtering is required.

Syntax

PFN_DEVICE_CALLBACK PfnDeviceCallback;

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

Parameters

pvParam

A parameter passed in from the pvParam member of the BLUETOOTH_SELECT_DEVICE_PARAMS structure through the BluetoothSelectDevices function.

pDevice

Return Value

Returning FALSE prevents the device from being added to the list view of Bluetooth devices.

Remarks

The BLUETOOTH_DEVICE_INFO structure pointed to in pDevice is the device that the BluetoothSelectDevices function is querying to determine if that device should be added to the list view.

If the callback performs SDP queries for each device, the list of devices from which the user can choose will be delayed until all devices can be queried. A recommended approach is to use the service to call bitfield in the class of device, available through GET_COD_SERVICE, to determine whether the device should be displayed to the user. The service class bitfield is available in the pDevice parameter through the ulClassOfDevice member.

Requirements

   
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)

See Also

BLUETOOTH_DEVICE_INFO

BLUETOOTH_SELECT_DEVICE_PARAMS

BluetoothSelectDevices