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 會傳回下列值:
傳回碼 | 描述 |
---|---|
|
作業已成功完成。 |
|
如果同時提供父服務和服務句柄,而且服務階層不會匯總至提供的父服務句柄,則傳回 。 |
|
參數無效。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 和更新版本的 Windows 支援。 |
目標平台 | Universal |
標頭 | bluetoothleapis.h |
程式庫 | BluetoothApis.lib |
Dll | BluetoothAPIs.dll |