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
S_OK
 Operazione riuscita.
ERROR_ACCESS_DENIED
 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.
ERROR_INVALID_PARAMETER
 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

BTH_LE_GATT_EVENT_TYPE

Funzione di callback dell'evento GATT Bluetooth

BluetoothGATTUnregisterEvent

  • Last updated on