PFN_DEVICE_CALLBACK función de devolución de llamada (bluetoothapis.h)
La función PFN_DEVICE_CALLBACK es un prototipo de devolución de llamada que se usa en asociación con la selección de dispositivos Bluetooth. La función PFN_DEVICE_CALLBACK se puede establecer en NULL si no se requiere ningún filtrado especializado.
Sintaxis
PFN_DEVICE_CALLBACK PfnDeviceCallback;
BOOL PfnDeviceCallback(
LPVOID pvParam,
const BLUETOOTH_DEVICE_INFO *pDevice
)
{...}
Parámetros
pvParam
Parámetro pasado desde el miembro pvParam de la estructura BLUETOOTH_SELECT_DEVICE_PARAMS a través de la función BluetoothSelectDevices .
pDevice
Dirección Bluetooth remota consultada; esta es la dirección insertada en la lista presentada por el usuario de dispositivos Bluetooth.
Valor devuelto
Devolver FALSE impide que el dispositivo se agregue a la vista de lista de dispositivos Bluetooth.
Comentarios
La estructura de BLUETOOTH_DEVICE_INFO a la que apunta pDevice es el dispositivo al que consulta la función BluetoothSelectDevices para determinar si ese dispositivo se debe agregar a la vista de lista.
Si la devolución de llamada realiza consultas SDP para cada dispositivo, la lista de dispositivos desde los que el usuario puede elegir se retrasará hasta que se puedan consultar todos los dispositivos. Un enfoque recomendado es usar el servicio para llamar al campo de bits en la clase de dispositivo, disponible a través de GET_COD_SERVICE, para determinar si el dispositivo debe mostrarse al usuario. El campo de bits de la clase de servicio está disponible en el parámetro pDevice a través del miembro ulClassOfDevice .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | bluetoothapis.h (incluye Bthsdpdef.h, BluetoothAPIs.h) |