ホーム › UI.WindowsAndMessaging › _DEV_BROADCAST_USERDEFINED

_DEV_BROADCAST_USERDEFINED

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dbud_dbh	DEV_BROADCAST_HDR	12	+0	+0	WM_DEVICECHANGE メッセージの影響を受けるデバイスに関する情報で、 DEV_BROADCAST_HDR 構造体によって指定されます。_DEV_BROADCAST_USERDEFINED は可変長であるため、dbud_dbh 構造体の dbch_size メンバーは、可変長部分を含む構造体全体のサイズ (バイト単位) でなければなりません。
dbud_szName	CHAR	1	+12	+12	メッセージの名前を表す、大文字と小文字を区別する null 終端文字列へのポインターです。この文字列は、ベンダー名、バックスラッシュ、それに続く任意のユーザー定義の null 終端テキストで構成されていなければなりません。

公式ドキュメント

DBT_USERDEFINED デバイスイベントに関連付けられた、ユーザー定義のイベントと省略可能なデータを格納します。

解説(Remarks)

この構造体は可変長のフィールドを含むため、ユーザー定義の構造体へのポインターを作成するためのテンプレートとして使用してください。構造体にポインターを含めてはならない点に注意してください。次の例は、そのようなユーザー定義の構造体を示しています。

#define NAME_LENGTH 32 
#define USER_LENGTH 50 
 
typedef struct tagWIDGET_WARE_DEV_BROADCAST_USERDEFINED
{
    struct _DEV_BROADCAST_HDR DBHeader; 
    char   szName[NAME_LENGTH];
    BYTE   UserDefined[USER_LENGTH]; 
} WIDGET_WARE_DEV_BROADCAST_USERDEFINED;

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// DEV_BROADCAST_HDR  (x64 12 / x86 12 バイト)
typedef struct DEV_BROADCAST_HDR {
    DWORD dbch_size;
    DEV_BROADCAST_HDR_DEVICE_TYPE dbch_devicetype;
    DWORD dbch_reserved;
} DEV_BROADCAST_HDR;

// _DEV_BROADCAST_USERDEFINED  (x64 16 / x86 16 バイト)
typedef struct _DEV_BROADCAST_USERDEFINED {
    DEV_BROADCAST_HDR dbud_dbh;
    CHAR dbud_szName[1];
} _DEV_BROADCAST_USERDEFINED;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DEV_BROADCAST_HDR
{
    public uint dbch_size;
    public uint dbch_devicetype;
    public uint dbch_reserved;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct _DEV_BROADCAST_USERDEFINED
{
    public DEV_BROADCAST_HDR dbud_dbh;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public sbyte[] dbud_szName;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DEV_BROADCAST_HDR
    Public dbch_size As UInteger
    Public dbch_devicetype As UInteger
    Public dbch_reserved As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure _DEV_BROADCAST_USERDEFINED
    Public dbud_dbh As DEV_BROADCAST_HDR
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public dbud_szName() As SByte
End Structure

import ctypes
from ctypes import wintypes

class DEV_BROADCAST_HDR(ctypes.Structure):
    _fields_ = [
        ("dbch_size", wintypes.DWORD),
        ("dbch_devicetype", wintypes.DWORD),
        ("dbch_reserved", wintypes.DWORD),
    ]

class _DEV_BROADCAST_USERDEFINED(ctypes.Structure):
    _fields_ = [
        ("dbud_dbh", DEV_BROADCAST_HDR),
        ("dbud_szName", ctypes.c_byte * 1),
    ]

#[repr(C)]
pub struct DEV_BROADCAST_HDR {
    pub dbch_size: u32,
    pub dbch_devicetype: u32,
    pub dbch_reserved: u32,
}

#[repr(C)]
pub struct _DEV_BROADCAST_USERDEFINED {
    pub dbud_dbh: DEV_BROADCAST_HDR,
    pub dbud_szName: [i8; 1],
}

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

type DEV_BROADCAST_HDR struct {
	dbch_size uint32
	dbch_devicetype uint32
	dbch_reserved uint32
}

type _DEV_BROADCAST_USERDEFINED struct {
	dbud_dbh DEV_BROADCAST_HDR
	dbud_szName [1]int8
}

type
  DEV_BROADCAST_HDR = record
    dbch_size: DWORD;
    dbch_devicetype: DWORD;
    dbch_reserved: DWORD;
  end;

  _DEV_BROADCAST_USERDEFINED = record
    dbud_dbh: DEV_BROADCAST_HDR;
    dbud_szName: array[0..0] of Shortint;
  end;

const DEV_BROADCAST_HDR = extern struct {
    dbch_size: u32,
    dbch_devicetype: u32,
    dbch_reserved: u32,
};

const _DEV_BROADCAST_USERDEFINED = extern struct {
    dbud_dbh: DEV_BROADCAST_HDR,
    dbud_szName: [1]i8,
};

type
  DEV_BROADCAST_HDR {.bycopy.} = object
    dbch_size: uint32
    dbch_devicetype: uint32
    dbch_reserved: uint32

  _DEV_BROADCAST_USERDEFINED {.bycopy.} = object
    dbud_dbh: DEV_BROADCAST_HDR
    dbud_szName: array[1, int8]

struct DEV_BROADCAST_HDR
{
    uint dbch_size;
    uint dbch_devicetype;
    uint dbch_reserved;
}

struct _DEV_BROADCAST_USERDEFINED
{
    DEV_BROADCAST_HDR dbud_dbh;
    byte[1] dbud_szName;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; _DEV_BROADCAST_USERDEFINED サイズ: 16 バイト(x64)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; dbud_dbh : DEV_BROADCAST_HDR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; dbud_szName : CHAR (+12, 1byte)  varptr(st)+12 を基点に操作(1byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

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

#defstruct global _DEV_BROADCAST_USERDEFINED
    #field DEV_BROADCAST_HDR dbud_dbh
    #field byte dbud_szName 1
#endstruct

stdim st, _DEV_BROADCAST_USERDEFINED        ; NSTRUCT 変数を確保