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

MSLLHOOKSTRUCT

構造体
サイズx64: 32 バイト / x86: 24 バイト

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

フィールド

フィールドサイズx64x86説明
ptPOINT8+0+0カーソルの x 座標と y 座標です。モニターごとの DPI 対応のスクリーン座標で表されます。
mouseDataDWORD4+8+8

メッセージが WM_MOUSEWHEEL の場合、このメンバーの上位ワードはホイールの移動量 (デルタ) です。下位ワードは予約済みです。正の値はホイールがユーザーから離れる方向 (前方) に回転したことを示し、負の値はホイールがユーザーの方向 (後方) に回転したことを示します。ホイールの 1 クリックは WHEEL_DELTA として定義されており、その値は 120 です。

メッセージが WM_XBUTTONDOWNWM_XBUTTONUPWM_XBUTTONDBLCLKWM_NCXBUTTONDOWNWM_NCXBUTTONUPWM_NCXBUTTONDBLCLK のいずれかの場合、上位ワードはどの X ボタンが押されたか、または離されたかを指定し、下位ワードは予約済みです。この値には次の値のうち 1 つ以上を指定できます。それ以外の場合、 mouseData は使用されません。

意味
XBUTTON1
0x0001
1 番目の X ボタンが押されたか、離されました。
XBUTTON2
0x0002
2 番目の X ボタンが押されたか、離されました。
flagsDWORD4+12+12

イベントが挿入されたことを示すフラグです。アプリケーションは次の値を使用してフラグをテストできます。LLMHF_INJECTED (ビット 0) をテストすると、そのイベントが挿入されたものかどうかがわかります。挿入されたものである場合、さらに LLMHF_LOWER_IL_INJECTED (ビット 1) をテストすると、より低い整合性レベルで実行されているプロセスから挿入されたかどうかがわかります。

意味
LLMHF_INJECTED
0x00000001
イベントが (任意のプロセスから) 挿入されたことを示すフラグをテストします。
LLMHF_LOWER_IL_INJECTED
0x00000002
イベントが (より低い整合性レベルで実行されているプロセスから) 挿入されたことを示すフラグをテストします。
timeDWORD4+16+16このメッセージのタイムスタンプです。
dwExtraInfoUINT_PTR8/4+24+20メッセージに関連付けられた追加情報です。

公式ドキュメント

低レベルのマウス入力イベントに関する情報を格納します。

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

各言語での定義

#include <windows.h>

// POINT  (x64 8 / x86 8 バイト)
typedef struct POINT {
    INT x;
    INT y;
} POINT;

// MSLLHOOKSTRUCT  (x64 32 / x86 24 バイト)
typedef struct MSLLHOOKSTRUCT {
    POINT pt;
    DWORD mouseData;
    DWORD flags;
    DWORD time;
    UINT_PTR dwExtraInfo;
} MSLLHOOKSTRUCT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINT
{
    public int x;
    public int y;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MSLLHOOKSTRUCT
{
    public POINT pt;
    public uint mouseData;
    public uint flags;
    public uint time;
    public UIntPtr dwExtraInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINT
    Public x As Integer
    Public y As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MSLLHOOKSTRUCT
    Public pt As POINT
    Public mouseData As UInteger
    Public flags As UInteger
    Public time As UInteger
    Public dwExtraInfo As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class POINT(ctypes.Structure):
    _fields_ = [
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
    ]

class MSLLHOOKSTRUCT(ctypes.Structure):
    _fields_ = [
        ("pt", POINT),
        ("mouseData", wintypes.DWORD),
        ("flags", wintypes.DWORD),
        ("time", wintypes.DWORD),
        ("dwExtraInfo", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct POINT {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct MSLLHOOKSTRUCT {
    pub pt: POINT,
    pub mouseData: u32,
    pub flags: u32,
    pub time: u32,
    pub dwExtraInfo: usize,
}
import "golang.org/x/sys/windows"

type POINT struct {
	x int32
	y int32
}

type MSLLHOOKSTRUCT struct {
	pt POINT
	mouseData uint32
	flags uint32
	time uint32
	dwExtraInfo uintptr
}
type
  POINT = record
    x: Integer;
    y: Integer;
  end;

  MSLLHOOKSTRUCT = record
    pt: POINT;
    mouseData: DWORD;
    flags: DWORD;
    time: DWORD;
    dwExtraInfo: NativeUInt;
  end;
const POINT = extern struct {
    x: i32,
    y: i32,
};

const MSLLHOOKSTRUCT = extern struct {
    pt: POINT,
    mouseData: u32,
    flags: u32,
    time: u32,
    dwExtraInfo: usize,
};
type
  POINT {.bycopy.} = object
    x: int32
    y: int32

  MSLLHOOKSTRUCT {.bycopy.} = object
    pt: POINT
    mouseData: uint32
    flags: uint32
    time: uint32
    dwExtraInfo: uint
struct POINT
{
    int x;
    int y;
}

struct MSLLHOOKSTRUCT
{
    POINT pt;
    uint mouseData;
    uint flags;
    uint time;
    size_t dwExtraInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MSLLHOOKSTRUCT サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; pt : POINT (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; mouseData : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; flags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; time : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwExtraInfo : UINT_PTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MSLLHOOKSTRUCT サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; pt : POINT (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; mouseData : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; flags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; time : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwExtraInfo : UINT_PTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global POINT
    #field int x
    #field int y
#endstruct

#defstruct global MSLLHOOKSTRUCT
    #field POINT pt
    #field int mouseData
    #field int flags
    #field int time
    #field intptr dwExtraInfo
#endstruct

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