Win32 API 日本語リファレンス
ホーム › Devices.Bluetooth › BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION

BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 40 バイト / x86: 40 バイト

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

フィールド

フィールド型サイズx64x86説明
NumCharacteristicsWORD2+0+0監視対象とする特性の数を示す16ビット値。
CharacteristicsBTH_LE_GATT_CHARACTERISTIC36+4+4値変更通知を登録する特性の配列。可変長。

各言語での定義

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

// BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION  (x64 40 / x86 40 バイト)
typedef struct BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION {
    WORD NumCharacteristics;
    BTH_LE_GATT_CHARACTERISTIC Characteristics[1];
} BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION;
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;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION
{
    public ushort NumCharacteristics;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public BTH_LE_GATT_CHARACTERISTIC[] Characteristics;
}
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

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION
    Public NumCharacteristics As UShort
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public Characteristics() As BTH_LE_GATT_CHARACTERISTIC
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),
    ]

class BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION(ctypes.Structure):
    _fields_ = [
        ("NumCharacteristics", ctypes.c_ushort),
        ("Characteristics", BTH_LE_GATT_CHARACTERISTIC * 1),
    ]
#[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,
}

#[repr(C)]
pub struct BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION {
    pub NumCharacteristics: u16,
    pub Characteristics: [BTH_LE_GATT_CHARACTERISTIC; 1],
}
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 BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION struct {
	NumCharacteristics uint16
	Characteristics [1]BTH_LE_GATT_CHARACTERISTIC
}
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;

  BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION = record
    NumCharacteristics: Word;
    Characteristics: array[0..0] of BTH_LE_GATT_CHARACTERISTIC;
  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,
};

const BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION = extern struct {
    NumCharacteristics: u16,
    Characteristics: [1]BTH_LE_GATT_CHARACTERISTIC,
};
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

  BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION {.bycopy.} = object
    NumCharacteristics: uint16
    Characteristics: array[1, BTH_LE_GATT_CHARACTERISTIC]
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;
}

struct BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION
{
    ushort NumCharacteristics;
    BTH_LE_GATT_CHARACTERISTIC[1] Characteristics;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; NumCharacteristics : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; Characteristics : BTH_LE_GATT_CHARACTERISTIC (+4, 36byte)  varptr(st)+4 を基点に操作(36byte:入れ子/配列)
; ※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

#defstruct global BLUETOOTH_GATT_VALUE_CHANGED_EVENT_REGISTRATION
    #field short NumCharacteristics
    #field BTH_LE_GATT_CHARACTERISTIC Characteristics 1
#endstruct

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