Funzione BluetoothGATTRegisterEvent (bluetoothleapis.h)

Articolo
02/26/2024

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

Condividi tramite