PFN_DEVICE_CALLBACK Rückruffunktion (bluetoothapis.h)
Die funktion PFN_DEVICE_CALLBACK ist ein Rückrufprototyp, der in Verbindung mit der Auswahl von Bluetooth-Geräten verwendet wird. Die funktion PFN_DEVICE_CALLBACK kann auf NULL festgelegt werden, wenn keine spezielle Filterung erforderlich ist.
Syntax
PFN_DEVICE_CALLBACK PfnDeviceCallback;
BOOL PfnDeviceCallback(
LPVOID pvParam,
const BLUETOOTH_DEVICE_INFO *pDevice
)
{...}
Parameter
pvParam
Ein Parameter, der vom pvParam-Element der BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur über die BluetoothSelectDevices-Funktion übergeben wird.
pDevice
Abgefragte Bluetooth-Remoteadresse; Dies ist die Adresse, die in die vom Benutzer angezeigte Liste der Bluetooth-Geräte eingefügt wird.
Rückgabewert
Die Rückgabe von FALSE verhindert, dass das Gerät der Listenansicht von Bluetooth-Geräten hinzugefügt wird.
Hinweise
Die BLUETOOTH_DEVICE_INFO Struktur, auf die in pDevice verwiesen wird, ist das Gerät, das die BluetoothSelectDevices-Funktion abfragt , um zu bestimmen, ob dieses Gerät der Listenansicht hinzugefügt werden soll.
Wenn der Rückruf SDP-Abfragen für jedes Gerät ausführt, wird die Liste der Geräte, von denen der Benutzer auswählen kann, verzögert, bis alle Geräte abgefragt werden können. Ein empfohlener Ansatz ist die Verwendung des Diensts zum Aufrufen des Bitfelds in der Geräteklasse, die über GET_COD_SERVICE verfügbar ist, um zu bestimmen, ob das Gerät dem Benutzer angezeigt werden soll. Das Bitfeld der Dienstklasse ist im pDevice-Parameter über den ulClassOfDevice-Member verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h) |