PFN_DEVICE_CALLBACK bluetoothapis.h) (回呼函式
PFN_DEVICE_CALLBACK函式是與選取藍牙裝置相關聯的回呼原型。 如果不需要特殊篩選 ,PFN_DEVICE_CALLBACK 函式可以設定為 NULL 。
語法
PFN_DEVICE_CALLBACK PfnDeviceCallback;
BOOL PfnDeviceCallback(
LPVOID pvParam,
const BLUETOOTH_DEVICE_INFO *pDevice
)
{...}
參數
pvParam
透過 BluetoothSelectDevices 函式,從 BLUETOOTH_SELECT_DEVICE_PARAMS 結構的 pvParam 成員傳入的參數。
pDevice
查詢遠端藍牙位址;這是插入用戶呈現藍牙裝置清單的位址。
傳回值
傳回 FALSE 可防止裝置新增至藍牙裝置的清單檢視。
備註
pDevice 中所指向的BLUETOOTH_DEVICE_INFO結構是 BluetoothSelectDevices 函式正在查詢的裝置,以判斷該裝置是否應該新增至清單檢視。
如果回呼會針對每個裝置執行 SDP 查詢,則使用者可以選擇的裝置清單將會延遲,直到可以查詢所有裝置為止。 建議的方法是使用服務來呼叫裝置類別中的 bitfield,此類別可透過 GET_COD_SERVICE 取得,以判斷是否應該向使用者顯示裝置。 服務類別 bitfield 可透過 ulClassOfDevice 成員在 pDevice 參數中使用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h) |