BTH_DEVICE_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| flags | DWORD | 4 | +0 | +0 | 次の表に示すフラグの 1 つ以上を組み合わせた値です。
| ||||||||||||||||||||
| address | ULONGLONG | 8 | +8 | +8 | リモート Bluetooth デバイスのアドレスです。 | ||||||||||||||||||||
| classOfDevice | DWORD | 4 | +16 | +16 | リモート デバイスのデバイス クラス (COD: class of device) を表すビット フィールドです。COD は次の 4 つのフィールドで構成されます。 Format: GET_COD_FORMAT(classOfDevice) を使用して取得します。現在サポートされている形式は COD_VERSION のみです。 Major: GET_COD_MAJOR(classOfDevice) を使用して取得します。現在は次の値が定義されていますが、今後拡張される見込みです。接続先のリモート デバイスを決定する目的でメジャー クラス フィールドを使用しないでください。リモート デバイスが持てるメジャー クラス コードは 1 つだけであり、対象のプロファイルに適したコードであるとは限りません。 COD_MAJOR_MISCELLANEOUSCOD_MAJOR_COMPUTERCOD_MAJOR_PHONECOD_MAJOR_LAN_ACCESSCOD_MAJOR_AUDIOCOD_MAJOR_PERIPHERALCOD_MAJOR_IMAGINGCOD_MAJOR_UNCLASSIFIEDMinor: GET_COD_MINOR(classOfDevice) を使用して取得します。マイナー コードは各メジャー コードに固有であり、マイナー コードの形式はメジャー コードごとに定義されます。厳密に列挙値であるマイナー コードもあれば、ビット フィールド、またはビット フィールドと列挙値の組み合わせであるものもあります。 Service hints: GET_COD_SERVICE(classOfDevice) を使用して取得します。リモート デバイスの機能に関するヒントを提供します。 COD_SERVICE_LIMITEDCOD_SERVICE_POSITIONINGCOD_SERVICE_NETWORKINGCOD_SERVICE_RENDERINGCOD_SERVICE_CAPTURINGCOD_SERVICE_OBJECT_XFERCOD_SERVICE_AUDIOCOD_SERVICE_TELEPHONYCOD_SERVICE_INFORMATION | ||||||||||||||||||||
| name | CHAR | 248 | +20 | +20 | デバイスから報告される、リモート Bluetooth デバイスの名前です。UTF8 でエンコードされています。ユーザーがリモート Bluetooth デバイスに対してローカルで表示名を指定している場合がありますが、その名前は上書きされ、このメンバーには現れません。その名前は BluetoothGetDeviceInfo 関数を呼び出した場合にのみ取得できます。 |
公式ドキュメント
BTH_DEVICE_INFO 構造体は、Bluetooth デバイスに関する情報を格納します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// BTH_DEVICE_INFO (x64 272 / x86 272 バイト)
typedef struct BTH_DEVICE_INFO {
DWORD flags;
ULONGLONG address;
DWORD classOfDevice;
CHAR name[248];
} BTH_DEVICE_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BTH_DEVICE_INFO
{
public uint flags;
public ulong address;
public uint classOfDevice;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 248)] public sbyte[] name;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BTH_DEVICE_INFO
Public flags As UInteger
Public address As ULong
Public classOfDevice As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=248)> Public name() As SByte
End Structureimport ctypes
from ctypes import wintypes
class BTH_DEVICE_INFO(ctypes.Structure):
_fields_ = [
("flags", wintypes.DWORD),
("address", ctypes.c_ulonglong),
("classOfDevice", wintypes.DWORD),
("name", ctypes.c_byte * 248),
]#[repr(C)]
pub struct BTH_DEVICE_INFO {
pub flags: u32,
pub address: u64,
pub classOfDevice: u32,
pub name: [i8; 248],
}import "golang.org/x/sys/windows"
type BTH_DEVICE_INFO struct {
flags uint32
address uint64
classOfDevice uint32
name [248]int8
}type
BTH_DEVICE_INFO = record
flags: DWORD;
address: UInt64;
classOfDevice: DWORD;
name: array[0..247] of Shortint;
end;const BTH_DEVICE_INFO = extern struct {
flags: u32,
address: u64,
classOfDevice: u32,
name: [248]i8,
};type
BTH_DEVICE_INFO {.bycopy.} = object
flags: uint32
address: uint64
classOfDevice: uint32
name: array[248, int8]struct BTH_DEVICE_INFO
{
uint flags;
ulong address;
uint classOfDevice;
byte[248] name;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BTH_DEVICE_INFO サイズ: 272 バイト(x64)
dim st, 68 ; 4byte整数×68(構造体サイズ 272 / 4 切り上げ)
; flags : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; address : ULONGLONG (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; classOfDevice : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; name : CHAR (+20, 248byte) varptr(st)+20 を基点に操作(248byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global BTH_DEVICE_INFO
#field int flags
#field int64 address
#field int classOfDevice
#field byte name 248
#endstruct
stdim st, BTH_DEVICE_INFO ; NSTRUCT 変数を確保
st->flags = 100
mes "flags=" + st->flags