função de retorno de chamada PFN_DEVICE_CALLBACK (bluetoothapis.h)
A função PFN_DEVICE_CALLBACK é um protótipo de retorno de chamada usado em associação com a seleção de dispositivos Bluetooth. A função PFN_DEVICE_CALLBACK poderá ser definida como NULL se nenhuma filtragem especializada for necessária.
Sintaxe
PFN_DEVICE_CALLBACK PfnDeviceCallback;
BOOL PfnDeviceCallback(
LPVOID pvParam,
const BLUETOOTH_DEVICE_INFO *pDevice
)
{...}
Parâmetros
pvParam
Um parâmetro passado do membro pvParam da estrutura BLUETOOTH_SELECT_DEVICE_PARAMS por meio da função BluetoothSelectDevices .
pDevice
Endereço Bluetooth remoto consultado; esse é o endereço inserido na lista apresentada pelo usuário de dispositivos Bluetooth.
Retornar valor
Retornar FALSE impede que o dispositivo seja adicionado à exibição de lista de dispositivos Bluetooth.
Comentários
A estrutura BLUETOOTH_DEVICE_INFO apontada no pDevice é o dispositivo que a função BluetoothSelectDevices está consultando para determinar se esse dispositivo deve ser adicionado à exibição de lista.
Se o retorno de chamada executar consultas SDP para cada dispositivo, a lista de dispositivos dos quais o usuário pode escolher será atrasada até que todos os dispositivos possam ser consultados. Uma abordagem recomendada é usar o serviço para chamar bitfield na classe de dispositivo, disponível por meio de GET_COD_SERVICE, para determinar se o dispositivo deve ser exibido para o usuário. O campo bit da classe de serviço está disponível no parâmetro pDevice por meio do membro ulClassOfDevice .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h) |