ホーム › Devices.Bluetooth › BTH_LE_GATT_CHARACTERISTIC

BTH_LE_GATT_CHARACTERISTIC

構造体

サイズx64: 36 バイト / x86: 36 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
ServiceHandle	WORD	2	+0	+0	この特性が属するサービスの属性ハンドル。
CharacteristicUuid	BTH_LE_UUID	20	+4	+4	特性を識別するUUIDを保持するBTH_LE_UUID。
AttributeHandle	WORD	2	+24	+24	特性宣言の属性ハンドルを示す16ビット値。
CharacteristicValueHandle	WORD	2	+26	+26	特性値が格納される属性ハンドルを示す16ビット値。
IsBroadcastable	BOOLEAN	1	+28	+28	ブロードキャスト可能かを示すブール値。
IsReadable	BOOLEAN	1	+29	+29	読み取り可能かを示すブール値。
IsWritable	BOOLEAN	1	+30	+30	応答付き書き込みが可能かを示すブール値。
IsWritableWithoutResponse	BOOLEAN	1	+31	+31	応答なし書き込みが可能かを示すブール値。
IsSignedWritable	BOOLEAN	1	+32	+32	署名付き書き込みが可能かを示すブール値。
IsNotifiable	BOOLEAN	1	+33	+33	通知(Notify)が可能かを示すブール値。
IsIndicatable	BOOLEAN	1	+34	+34	通知応答付き(Indicate)が可能かを示すブール値。
HasExtendedProperties	BOOLEAN	1	+35	+35	拡張プロパティ記述子を持つかを示すブール値。

各言語での定義

#include <windows.h>

// BTH_LE_UUID  (x64 20 / x86 20 バイト)
typedef struct BTH_LE_UUID {
    BOOLEAN IsShortUuid;
    _Value_e__Union Value;
} BTH_LE_UUID;

// BTH_LE_GATT_CHARACTERISTIC  (x64 36 / x86 36 バイト)
typedef struct BTH_LE_GATT_CHARACTERISTIC {
    WORD ServiceHandle;
    BTH_LE_UUID CharacteristicUuid;
    WORD AttributeHandle;
    WORD CharacteristicValueHandle;
    BOOLEAN IsBroadcastable;
    BOOLEAN IsReadable;
    BOOLEAN IsWritable;
    BOOLEAN IsWritableWithoutResponse;
    BOOLEAN IsSignedWritable;
    BOOLEAN IsNotifiable;
    BOOLEAN IsIndicatable;
    BOOLEAN HasExtendedProperties;
} BTH_LE_GATT_CHARACTERISTIC;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BTH_LE_UUID
{
    [MarshalAs(UnmanagedType.U1)] public bool IsShortUuid;
    public _Value_e__Union Value;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BTH_LE_GATT_CHARACTERISTIC
{
    public ushort ServiceHandle;
    public BTH_LE_UUID CharacteristicUuid;
    public ushort AttributeHandle;
    public ushort CharacteristicValueHandle;
    [MarshalAs(UnmanagedType.U1)] public bool IsBroadcastable;
    [MarshalAs(UnmanagedType.U1)] public bool IsReadable;
    [MarshalAs(UnmanagedType.U1)] public bool IsWritable;
    [MarshalAs(UnmanagedType.U1)] public bool IsWritableWithoutResponse;
    [MarshalAs(UnmanagedType.U1)] public bool IsSignedWritable;
    [MarshalAs(UnmanagedType.U1)] public bool IsNotifiable;
    [MarshalAs(UnmanagedType.U1)] public bool IsIndicatable;
    [MarshalAs(UnmanagedType.U1)] public bool HasExtendedProperties;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BTH_LE_UUID
    <MarshalAs(UnmanagedType.U1)> Public IsShortUuid As Boolean
    Public Value As _Value_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BTH_LE_GATT_CHARACTERISTIC
    Public ServiceHandle As UShort
    Public CharacteristicUuid As BTH_LE_UUID
    Public AttributeHandle As UShort
    Public CharacteristicValueHandle As UShort
    <MarshalAs(UnmanagedType.U1)> Public IsBroadcastable As Boolean
    <MarshalAs(UnmanagedType.U1)> Public IsReadable As Boolean
    <MarshalAs(UnmanagedType.U1)> Public IsWritable As Boolean
    <MarshalAs(UnmanagedType.U1)> Public IsWritableWithoutResponse As Boolean
    <MarshalAs(UnmanagedType.U1)> Public IsSignedWritable As Boolean
    <MarshalAs(UnmanagedType.U1)> Public IsNotifiable As Boolean
    <MarshalAs(UnmanagedType.U1)> Public IsIndicatable As Boolean
    <MarshalAs(UnmanagedType.U1)> Public HasExtendedProperties As Boolean
End Structure

import ctypes
from ctypes import wintypes

class BTH_LE_UUID(ctypes.Structure):
    _fields_ = [
        ("IsShortUuid", ctypes.c_byte),
        ("Value", _Value_e__Union),
    ]

class BTH_LE_GATT_CHARACTERISTIC(ctypes.Structure):
    _fields_ = [
        ("ServiceHandle", ctypes.c_ushort),
        ("CharacteristicUuid", BTH_LE_UUID),
        ("AttributeHandle", ctypes.c_ushort),
        ("CharacteristicValueHandle", ctypes.c_ushort),
        ("IsBroadcastable", ctypes.c_byte),
        ("IsReadable", ctypes.c_byte),
        ("IsWritable", ctypes.c_byte),
        ("IsWritableWithoutResponse", ctypes.c_byte),
        ("IsSignedWritable", ctypes.c_byte),
        ("IsNotifiable", ctypes.c_byte),
        ("IsIndicatable", ctypes.c_byte),
        ("HasExtendedProperties", ctypes.c_byte),
    ]

#[repr(C)]
pub struct BTH_LE_UUID {
    pub IsShortUuid: u8,
    pub Value: _Value_e__Union,
}

#[repr(C)]
pub struct BTH_LE_GATT_CHARACTERISTIC {
    pub ServiceHandle: u16,
    pub CharacteristicUuid: BTH_LE_UUID,
    pub AttributeHandle: u16,
    pub CharacteristicValueHandle: u16,
    pub IsBroadcastable: u8,
    pub IsReadable: u8,
    pub IsWritable: u8,
    pub IsWritableWithoutResponse: u8,
    pub IsSignedWritable: u8,
    pub IsNotifiable: u8,
    pub IsIndicatable: u8,
    pub HasExtendedProperties: u8,
}

import "golang.org/x/sys/windows"

type BTH_LE_UUID struct {
	IsShortUuid byte
	Value _Value_e__Union
}

type BTH_LE_GATT_CHARACTERISTIC struct {
	ServiceHandle uint16
	CharacteristicUuid BTH_LE_UUID
	AttributeHandle uint16
	CharacteristicValueHandle uint16
	IsBroadcastable byte
	IsReadable byte
	IsWritable byte
	IsWritableWithoutResponse byte
	IsSignedWritable byte
	IsNotifiable byte
	IsIndicatable byte
	HasExtendedProperties byte
}

type
  BTH_LE_UUID = record
    IsShortUuid: ByteBool;
    Value: _Value_e__Union;
  end;

  BTH_LE_GATT_CHARACTERISTIC = record
    ServiceHandle: Word;
    CharacteristicUuid: BTH_LE_UUID;
    AttributeHandle: Word;
    CharacteristicValueHandle: Word;
    IsBroadcastable: ByteBool;
    IsReadable: ByteBool;
    IsWritable: ByteBool;
    IsWritableWithoutResponse: ByteBool;
    IsSignedWritable: ByteBool;
    IsNotifiable: ByteBool;
    IsIndicatable: ByteBool;
    HasExtendedProperties: ByteBool;
  end;

const BTH_LE_UUID = extern struct {
    IsShortUuid: u8,
    Value: _Value_e__Union,
};

const BTH_LE_GATT_CHARACTERISTIC = extern struct {
    ServiceHandle: u16,
    CharacteristicUuid: BTH_LE_UUID,
    AttributeHandle: u16,
    CharacteristicValueHandle: u16,
    IsBroadcastable: u8,
    IsReadable: u8,
    IsWritable: u8,
    IsWritableWithoutResponse: u8,
    IsSignedWritable: u8,
    IsNotifiable: u8,
    IsIndicatable: u8,
    HasExtendedProperties: u8,
};

type
  BTH_LE_UUID {.bycopy.} = object
    IsShortUuid: uint8
    Value: _Value_e__Union

  BTH_LE_GATT_CHARACTERISTIC {.bycopy.} = object
    ServiceHandle: uint16
    CharacteristicUuid: BTH_LE_UUID
    AttributeHandle: uint16
    CharacteristicValueHandle: uint16
    IsBroadcastable: uint8
    IsReadable: uint8
    IsWritable: uint8
    IsWritableWithoutResponse: uint8
    IsSignedWritable: uint8
    IsNotifiable: uint8
    IsIndicatable: uint8
    HasExtendedProperties: uint8

struct BTH_LE_UUID
{
    ubyte IsShortUuid;
    _Value_e__Union Value;
}

struct BTH_LE_GATT_CHARACTERISTIC
{
    ushort ServiceHandle;
    BTH_LE_UUID CharacteristicUuid;
    ushort AttributeHandle;
    ushort CharacteristicValueHandle;
    ubyte IsBroadcastable;
    ubyte IsReadable;
    ubyte IsWritable;
    ubyte IsWritableWithoutResponse;
    ubyte IsSignedWritable;
    ubyte IsNotifiable;
    ubyte IsIndicatable;
    ubyte HasExtendedProperties;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BTH_LE_GATT_CHARACTERISTIC サイズ: 36 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; ServiceHandle : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; CharacteristicUuid : BTH_LE_UUID (+4, 20byte)  varptr(st)+4 を基点に操作(20byte:入れ子/配列)
; AttributeHandle : WORD (+24, 2byte)  wpoke st,24,値  /  値 = wpeek(st,24)
; CharacteristicValueHandle : WORD (+26, 2byte)  wpoke st,26,値  /  値 = wpeek(st,26)
; IsBroadcastable : BOOLEAN (+28, 1byte)  poke st,28,値  /  値 = peek(st,28)
; IsReadable : BOOLEAN (+29, 1byte)  poke st,29,値  /  値 = peek(st,29)
; IsWritable : BOOLEAN (+30, 1byte)  poke st,30,値  /  値 = peek(st,30)
; IsWritableWithoutResponse : BOOLEAN (+31, 1byte)  poke st,31,値  /  値 = peek(st,31)
; IsSignedWritable : BOOLEAN (+32, 1byte)  poke st,32,値  /  値 = peek(st,32)
; IsNotifiable : BOOLEAN (+33, 1byte)  poke st,33,値  /  値 = peek(st,33)
; IsIndicatable : BOOLEAN (+34, 1byte)  poke st,34,値  /  値 = peek(st,34)
; HasExtendedProperties : BOOLEAN (+35, 1byte)  poke st,35,値  /  値 = peek(st,35)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global BTH_LE_UUID
    #field bool1 IsShortUuid
    #field byte Value 16
#endstruct

#defstruct global BTH_LE_GATT_CHARACTERISTIC
    #field short ServiceHandle
    #field BTH_LE_UUID CharacteristicUuid
    #field short AttributeHandle
    #field short CharacteristicValueHandle
    #field bool1 IsBroadcastable
    #field bool1 IsReadable
    #field bool1 IsWritable
    #field bool1 IsWritableWithoutResponse
    #field bool1 IsSignedWritable
    #field bool1 IsNotifiable
    #field bool1 IsIndicatable
    #field bool1 HasExtendedProperties
#endstruct

stdim st, BTH_LE_GATT_CHARACTERISTIC        ; NSTRUCT 変数を確保
st->ServiceHandle = 100
mes "ServiceHandle=" + st->ServiceHandle

BTH_LE_GATT_CHARACTERISTIC

フィールド

各言語での定義

HSP用 定義

HSP用定義