Funzione BluetoothGATTRegisterEvent (bluetoothleapis.h)
La funzione BluetoothGATTRegisterEvent registra una routine da chiamare durante un evento di modifica del valore caratteristica sulla caratteristica identificata dalla relativa handle caratteristica.
Sintassi
HRESULT BluetoothGATTRegisterEvent(
[in] HANDLE hService,
[in] BTH_LE_GATT_EVENT_TYPE EventType,
[in] PVOID EventParameterIn,
[in] PFNBLUETOOTH_GATT_EVENT_CALLBACK Callback,
[in, optional] PVOID CallbackContext,
[out] BLUETOOTH_GATT_EVENT_HANDLE *pEventHandle,
[in] ULONG Flags
);
Parametri
[in] hService
Gestire il servizio.
[in] EventType
Valore da BTH_LE_GATT_EVENT_TYPE. Attualmente è supportato solo CharacteristicValueChangedEvent .
[in] EventParameterIn
Puntatore a una struttura BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION da passare quando viene attivato l'evento.
[in] Callback
Routine da chiamare quando il valore caratteristica cambia.
[in, optional] CallbackContext
Contesto da passare a Callback.
[out] pEventHandle
Puntatore al buffer per ricevere un handle per la registrazione. I driver del profilo devono passare questo handle quando si chiama BluetoothGATTUnregisterEvent.
[in] Flags
Flag per modificare il comportamento di BluetoothGATTRegisterEvent:
Flag | Descrizione |
---|---|
BLUETOOTH_GATT_FLAG_NONE | Il client non ha requisiti GATT specifici (impostazione predefinita). |
Valore restituito
BluetoothGATTRegisterEvent restituisce i valori seguenti:
Codice restituito | Descrizione |
---|---|
|
Operazione riuscita. |
|
Restituito se vengono forniti sia un servizio padre che un handle di servizio e la gerarchia del servizio non viene implementata nell'handle del servizio padre fornito. |
|
Parametro non valido. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Supportato in Windows 8 e versioni successive di Windows. |
Piattaforma di destinazione | Universale |
Intestazione | bluetoothleapis.h |
Libreria | BluetoothApis.lib |
DLL | BluetoothAPIs.dll |
Vedi anche
BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION