Win32 API 日本語リファレンス
ホームUI.WindowsAndMessaging › DEV_BROADCAST_HANDLE

DEV_BROADCAST_HANDLE

構造体
サイズx64: 56 バイト / x86: 44 バイト

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

フィールド

フィールドサイズx64x86説明
dbch_sizeDWORD4+0+0この構造体のサイズ(バイト数)である。
dbch_devicetypeDWORD4+4+4デバイスの種類を示す値である(DBT_DEVTYP_HANDLE)。
dbch_reservedDWORD4+8+8予約済みである。使用しない。
dbch_handleHANDLE8/4+16+12通知を要求したデバイスのハンドルである。
dbch_hdevnotifyHDEVNOTIFY8/4+24+16RegisterDeviceNotification が返したデバイス通知ハンドルである。
dbch_eventguidGUID16+32+20発生したイベントを識別する GUID である。
dbch_nameoffsetINT4+48+36イベント名文字列へのオフセットである。名前がない場合は -1 となる。
dbch_dataBYTE1+52+40イベントに関連付けられた追加データの先頭バイトである。

各言語での定義

#include <windows.h>

// DEV_BROADCAST_HANDLE  (x64 56 / x86 44 バイト)
typedef struct DEV_BROADCAST_HANDLE {
    DWORD dbch_size;
    DWORD dbch_devicetype;
    DWORD dbch_reserved;
    HANDLE dbch_handle;
    HDEVNOTIFY dbch_hdevnotify;
    GUID dbch_eventguid;
    INT dbch_nameoffset;
    BYTE dbch_data[1];
} DEV_BROADCAST_HANDLE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DEV_BROADCAST_HANDLE
{
    public uint dbch_size;
    public uint dbch_devicetype;
    public uint dbch_reserved;
    public IntPtr dbch_handle;
    public IntPtr dbch_hdevnotify;
    public Guid dbch_eventguid;
    public int dbch_nameoffset;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public byte[] dbch_data;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DEV_BROADCAST_HANDLE
    Public dbch_size As UInteger
    Public dbch_devicetype As UInteger
    Public dbch_reserved As UInteger
    Public dbch_handle As IntPtr
    Public dbch_hdevnotify As IntPtr
    Public dbch_eventguid As Guid
    Public dbch_nameoffset As Integer
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public dbch_data() As Byte
End Structure
import ctypes
from ctypes import wintypes

class DEV_BROADCAST_HANDLE(ctypes.Structure):
    _fields_ = [
        ("dbch_size", wintypes.DWORD),
        ("dbch_devicetype", wintypes.DWORD),
        ("dbch_reserved", wintypes.DWORD),
        ("dbch_handle", ctypes.c_void_p),
        ("dbch_hdevnotify", ctypes.c_void_p),
        ("dbch_eventguid", GUID),
        ("dbch_nameoffset", ctypes.c_int),
        ("dbch_data", ctypes.c_ubyte * 1),
    ]
#[repr(C)]
pub struct DEV_BROADCAST_HANDLE {
    pub dbch_size: u32,
    pub dbch_devicetype: u32,
    pub dbch_reserved: u32,
    pub dbch_handle: *mut core::ffi::c_void,
    pub dbch_hdevnotify: *mut core::ffi::c_void,
    pub dbch_eventguid: GUID,
    pub dbch_nameoffset: i32,
    pub dbch_data: [u8; 1],
}
import "golang.org/x/sys/windows"

type DEV_BROADCAST_HANDLE struct {
	dbch_size uint32
	dbch_devicetype uint32
	dbch_reserved uint32
	dbch_handle uintptr
	dbch_hdevnotify uintptr
	dbch_eventguid windows.GUID
	dbch_nameoffset int32
	dbch_data [1]byte
}
type
  DEV_BROADCAST_HANDLE = record
    dbch_size: DWORD;
    dbch_devicetype: DWORD;
    dbch_reserved: DWORD;
    dbch_handle: Pointer;
    dbch_hdevnotify: Pointer;
    dbch_eventguid: TGUID;
    dbch_nameoffset: Integer;
    dbch_data: array[0..0] of Byte;
  end;
const DEV_BROADCAST_HANDLE = extern struct {
    dbch_size: u32,
    dbch_devicetype: u32,
    dbch_reserved: u32,
    dbch_handle: ?*anyopaque,
    dbch_hdevnotify: ?*anyopaque,
    dbch_eventguid: GUID,
    dbch_nameoffset: i32,
    dbch_data: [1]u8,
};
type
  DEV_BROADCAST_HANDLE {.bycopy.} = object
    dbch_size: uint32
    dbch_devicetype: uint32
    dbch_reserved: uint32
    dbch_handle: pointer
    dbch_hdevnotify: pointer
    dbch_eventguid: GUID
    dbch_nameoffset: int32
    dbch_data: array[1, uint8]
struct DEV_BROADCAST_HANDLE
{
    uint dbch_size;
    uint dbch_devicetype;
    uint dbch_reserved;
    void* dbch_handle;
    void* dbch_hdevnotify;
    GUID dbch_eventguid;
    int dbch_nameoffset;
    ubyte[1] dbch_data;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DEV_BROADCAST_HANDLE サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; dbch_size : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dbch_devicetype : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dbch_reserved : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dbch_handle : HANDLE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dbch_hdevnotify : HDEVNOTIFY (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dbch_eventguid : GUID (+20, 16byte)  varptr(st)+20 を基点に操作(16byte:入れ子/配列)
; dbch_nameoffset : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dbch_data : BYTE (+40, 1byte)  varptr(st)+40 を基点に操作(1byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DEV_BROADCAST_HANDLE サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dbch_size : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dbch_devicetype : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dbch_reserved : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dbch_handle : HANDLE (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dbch_hdevnotify : HDEVNOTIFY (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dbch_eventguid : GUID (+32, 16byte)  varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; dbch_nameoffset : INT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dbch_data : BYTE (+52, 1byte)  varptr(st)+52 を基点に操作(1byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global DEV_BROADCAST_HANDLE
    #field int dbch_size
    #field int dbch_devicetype
    #field int dbch_reserved
    #field intptr dbch_handle
    #field intptr dbch_hdevnotify
    #field GUID dbch_eventguid
    #field int dbch_nameoffset
    #field byte dbch_data 1
#endstruct

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