Función BluetoothGATTRegisterEvent (bluetoothleapis.h)

Artículo
02/26/2024

La función BluetoothGATTRegisterEvent registra una rutina a la que se llamará durante un evento de cambio de valor de característica en la característica especificada identificada por su identificador de característica.

Sintaxis

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
);

Parámetros

[in] hService

Identificador del servicio.

[in] EventType

Valor de BTH_LE_GATT_EVENT_TYPE. Actualmente, solo se admite CharacteristicValueChangedEvent .

[in] EventParameterIn

Puntero a una estructura de BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION que se va a pasar cuando se desencadena el evento.

[in] Callback

Rutina a la que se va a llamar cuando cambia el valor de característica.

[in, optional] CallbackContext

Contexto que se va a pasar a devolución de llamada.

[out] pEventHandle

Puntero al búfer para recibir un identificador para el registro. Los controladores de perfil deben pasar este identificador al llamar a BluetoothGATTUnregisterEvent.

[in] Flags

Marcas para modificar el comportamiento de BluetoothGATTRegisterEvent:

Marca	Descripción
BLUETOOTH_GATT_FLAG_NONE	El cliente no tiene requisitos GATT específicos (valor predeterminado).

Valor devuelto

BluetoothGATTRegisterEvent devuelve los valores siguientes:

Código devuelto	Descripción
S_OK	La operación se ha completado correctamente.
ERROR_ACCESS_DENIED	Se devuelve si se proporciona un servicio primario y un identificador de servicio y la jerarquía de servicios no se acumula en el identificador de servicio primario proporcionado.
ERROR_INVALID_PARAMETER	Un parámetro no era válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en Windows 8 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	bluetoothleapis.h
Library	BluetoothApis.lib
Archivo DLL	BluetoothAPIs.dll

Consulte también

BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION

BTH_LE_GATT_EVENT_TYPE

Función de devolución de llamada de eventos GATT de Bluetooth

BluetoothGATTUnregisterEvent

Share via