Notify キューから 1 件取り出す
ble_notify_poll dev_h, "chr", var_buf, buf_size, var_len
dev_h : デバイスハンドル chr : characteristic UUID (空文字なら任意の chr) var_buf : バイト列を受け取る変数 (sdim 済) buf_size : var_buf に sdim で確保したバッファサイズ var_len : 受信バイト数を受け取る int 変数
(プラグイン / モジュール : hspble.dll)
指定 characteristic のキューから最古の 1 件を取り出して var_buf と var_len に格納します。chr を空文字にした場合は任意の chr の 1 件を取ります。stat=1 で成功、stat=0 でキューが空。 var_buf は事前に sdim で十分なサイズを確保し、その sdim サイズを buf_size に指定してください。
| ble_notify_enable | Notify 購読を有効化 | (hspble.dll) |
| プラグイン / モジュール | hspble.dll |
| バージョン | 1.0 |
| 作成日 | 2026-04-15 |
| 著作者 | IronHSP / hspble |
| URL | https://github.com/inovia/IronHSP |
| 備考 | hspble.dll は Windows 10 以降に搭載された Windows.Devices.Bluetooth
(WinRT) を使って、BLE セントラル機能 (GATT クライアント) を HSP3 に提供します。 提供機能: - BluetoothLEAdvertisementWatcher によるアドバタイズスキャン - BluetoothLEDevice::FromBluetoothAddressAsync による接続 - GATT サービス / キャラクタリスティックの列挙 - Read / Write / Notify 非同期 WinRT API は内部で .get() による同期待ちにしているので、 HSP 側からは通常の同期命令として扱えます。ただし接続や Read は 数百 ms ブロックすることがあるので、リアルタイム描画ループと 併用する場合は注意してください。 スキャン結果と Notify はバックグラウンドスレッドで内部キュー に蓄積され、ble_scan_poll / ble_notify_poll で 1 件ずつ取り 出す方式です (STA 不要)。 |
| タイプ | 拡張命令 |
| グループ | hspble ― Notify |
| 対応環境 |
|
| hs ファイル | hsphelp\hspble.hs |