BluetoothGATTRegisterEvent 函式 (bluetoothleapis.h)

BluetoothGATTRegisterEvent 函式會在特性控點所識別的指定特性變更事件期間，註冊要回呼的例程。

語法

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

參數

[in] hService

服務的句柄。

[in] EventType

來自 BTH_LE_GATT_EVENT_TYPE的值。 目前僅支援 CharacteristicValueChangedEvent 。

[in] EventParameterIn

觸發事件時要傳遞 之BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION 結構的指標。

[in] Callback

特性值變更時要呼叫的例程。

[in, optional] CallbackContext

要傳遞至 回呼的內容。

[out] pEventHandle

要接收註冊句柄的緩衝區指標。 呼叫 BluetoothGATTUnregisterEvent 時，配置文件驅動程式必須傳遞此句柄。

[in] Flags

用來修改 BluetoothGATTRegisterEvent 行為的旗標：

旗標	描述
BLUETOOTH_GATT_FLAG_NONE	客戶端沒有特定的 GATT 需求， (預設) 。

傳回值

BluetoothGATTRegisterEvent 會傳回下列值：

傳回碼	描述
S_OK	作業已成功完成。
ERROR_ACCESS_DENIED	如果同時提供父服務和服務句柄，而且服務階層不會匯總至提供的父服務句柄，則傳回 。
ERROR_INVALID_PARAMETER	參數無效。

規格需求

需求	值
最低支援的用戶端	Windows 8 和更新版本的 Windows 支援。
目標平台	Universal
標頭	bluetoothleapis.h
程式庫	BluetoothApis.lib
Dll	BluetoothAPIs.dll

另請參閱

BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION

BTH_LE_GATT_EVENT_TYPE

藍牙 GATT 事件回呼函式

BluetoothGATTUnregisterEvent