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

RAWKEYBOARD

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

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

フィールド

フィールド型サイズx64x86説明
MakeCodeWORD2+0+0キーの押下に関連付けられたスキャン コードを指定します。「解説」を参照してください。
FlagsWORD2+2+2

スキャン コード情報のフラグです。次の値の 1 つ以上を指定できます。

値 意味
RI_KEY_MAKE 0 キーが押されています。
RI_KEY_BREAK 1 キーが離されています。
RI_KEY_E0 2 スキャン コードに E0 プレフィックスが付いています。
RI_KEY_E1 4 スキャン コードに E1 プレフィックスが付いています。
ReservedWORD2+4+4予約済みです。0 でなければなりません。
VKeyWORD2+6+6対応する従来の仮想キー コードです。
MessageDWORD4+8+8対応する従来のキーボード ウィンドウ メッセージです。たとえば、WM_KEYDOWN、WM_SYSKEYDOWN などです。
ExtraInformationDWORD4+12+12イベントに関するデバイス固有の追加情報です。

公式ドキュメント

キーボードの状態に関する情報を格納します。

解説(Remarks)

KEYBOARD_OVERRUN_MAKE_CODE は、無効または認識できないキーの組み合わせが押された場合や、押されたキーの数がこのキーボードの上限を超えた場合に送信される特別な MakeCode 値です。

case WM_INPUT:
{
    UINT dwSize = sizeof(RAWINPUT);
    static BYTE lpb[sizeof(RAWINPUT)];

    GetRawInputData((HRAWINPUT)lParam, RID_INPUT, lpb, &dwSize, sizeof(RAWINPUTHEADER));

    RAWINPUT* raw = (RAWINPUT*)lpb;

    if (raw->header.dwType == RIM_TYPEKEYBOARD)
    {
        RAWKEYBOARD& keyboard = raw->data.keyboard;
        WORD scanCode = 0;
        BOOL keyUp = keyboard.Flags & RI_KEY_BREAK;

        // Ignore key overrun state and keys not mapped to any virtual key code
        if (keyboard.MakeCode == KEYBOARD_OVERRUN_MAKE_CODE || keyboard.VKey >= UCHAR_MAX)
            return 0;

        if (keyboard.MakeCode)
        {
            // Compose the full scan code value with its extended byte
            scanCode = MAKEWORD(keyboard.MakeCode & 0x7f, ((keyboard.Flags & RI_KEY_E0) ? 0xe0 : ((keyboard.Flags & RI_KEY_E1) ? 0xe1 : 0x00)));
        }
        else
        {
            // Scan code value may be empty for some buttons (for example multimedia buttons)
            // Try to get the scan code from the virtual key code
            scanCode = LOWORD(MapVirtualKey(keyboard.VKey, MAPVK_VK_TO_VSC_EX));
        }

        // Get the key name for debug output
        TCHAR keyNameBuffer[MAX_PATH] = {};
        GetKeyNameText((LONG)MAKELPARAM(0, (HIBYTE(scanCode) ? KF_EXTENDED : 0x00) | LOBYTE(scanCode)), keyNameBuffer, MAX_PATH);

        // Debug output
        TCHAR printBuffer[MAX_PATH] = {};
        StringCchPrintf(printBuffer, MAX_PATH, TEXT("Keyboard: scanCode=%04x keyName=%s\r\n"), scanCode, keyNameBuffer);
        OutputDebugString(printBuffer);
    }
    ...

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

各言語での定義

#include <windows.h>

// RAWKEYBOARD  (x64 16 / x86 16 バイト)
typedef struct RAWKEYBOARD {
    WORD MakeCode;
    WORD Flags;
    WORD Reserved;
    WORD VKey;
    DWORD Message;
    DWORD ExtraInformation;
} RAWKEYBOARD;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RAWKEYBOARD
{
    public ushort MakeCode;
    public ushort Flags;
    public ushort Reserved;
    public ushort VKey;
    public uint Message;
    public uint ExtraInformation;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RAWKEYBOARD
    Public MakeCode As UShort
    Public Flags As UShort
    Public Reserved As UShort
    Public VKey As UShort
    Public Message As UInteger
    Public ExtraInformation As UInteger
End Structure
import ctypes
from ctypes import wintypes

class RAWKEYBOARD(ctypes.Structure):
    _fields_ = [
        ("MakeCode", ctypes.c_ushort),
        ("Flags", ctypes.c_ushort),
        ("Reserved", ctypes.c_ushort),
        ("VKey", ctypes.c_ushort),
        ("Message", wintypes.DWORD),
        ("ExtraInformation", wintypes.DWORD),
    ]
#[repr(C)]
pub struct RAWKEYBOARD {
    pub MakeCode: u16,
    pub Flags: u16,
    pub Reserved: u16,
    pub VKey: u16,
    pub Message: u32,
    pub ExtraInformation: u32,
}
import "golang.org/x/sys/windows"

type RAWKEYBOARD struct {
	MakeCode uint16
	Flags uint16
	Reserved uint16
	VKey uint16
	Message uint32
	ExtraInformation uint32
}
type
  RAWKEYBOARD = record
    MakeCode: Word;
    Flags: Word;
    Reserved: Word;
    VKey: Word;
    Message: DWORD;
    ExtraInformation: DWORD;
  end;
const RAWKEYBOARD = extern struct {
    MakeCode: u16,
    Flags: u16,
    Reserved: u16,
    VKey: u16,
    Message: u32,
    ExtraInformation: u32,
};
type
  RAWKEYBOARD {.bycopy.} = object
    MakeCode: uint16
    Flags: uint16
    Reserved: uint16
    VKey: uint16
    Message: uint32
    ExtraInformation: uint32
struct RAWKEYBOARD
{
    ushort MakeCode;
    ushort Flags;
    ushort Reserved;
    ushort VKey;
    uint Message;
    uint ExtraInformation;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RAWKEYBOARD サイズ: 16 バイト(x64)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; MakeCode : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; Flags : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; Reserved : WORD (+4, 2byte)  wpoke st,4,値  /  値 = wpeek(st,4)
; VKey : WORD (+6, 2byte)  wpoke st,6,値  /  値 = wpeek(st,6)
; Message : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ExtraInformation : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RAWKEYBOARD
    #field short MakeCode
    #field short Flags
    #field short Reserved
    #field short VKey
    #field int Message
    #field int ExtraInformation
#endstruct

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