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

KEYBDINPUT

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

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

フィールド

フィールドサイズx64x86説明
wVkVIRTUAL_KEY2+0+0仮想キーコード。このコードは 1 から 254 の範囲の値でなければなりません。dwFlags メンバーが KEYEVENTF_UNICODE を指定している場合、wVk は 0 でなければなりません。
wScanWORD2+2+2キーのハードウェアスキャンコード。dwFlagsKEYEVENTF_UNICODE を指定している場合、wScan はフォアグラウンドアプリケーションに送信される Unicode 文字を指定します。
dwFlagsKEYBD_EVENT_FLAGS4+4+4

キーストロークのさまざまな側面を指定します。このメンバーには、次の値の特定の組み合わせを指定できます。

意味
KEYEVENTF_EXTENDEDKEY
0x0001
指定した場合、wScan のスキャンコードは 2 バイトのシーケンスで構成され、最初のバイトの値は 0xE0 になります。詳細については、拡張キーフラグを参照してください。
KEYEVENTF_KEYUP
0x0002
指定した場合、キーが離されたことを表します。指定しない場合、キーが押されたことを表します。
KEYEVENTF_SCANCODE
0x0008
指定した場合、wScan がキーを識別し、wVk は無視されます。
KEYEVENTF_UNICODE
0x0004
指定した場合、システムは VK_PACKET キーストロークを合成します。wVk パラメーターは 0 でなければなりません。このフラグは KEYEVENTF_KEYUP フラグとのみ組み合わせることができます。詳細については、「解説」セクションを参照してください。
timeDWORD4+8+8イベントのタイムスタンプ(ミリ秒単位)。このパラメーターが 0 の場合、システムが独自のタイムスタンプを提供します。
dwExtraInfoUINT_PTR8/4+16+12キーストロークに関連付けられた追加の値。この情報を取得するには、GetMessageExtraInfo 関数を使用します。

公式ドキュメント

シミュレートされたキーボードイベントに関する情報を格納します。

解説(Remarks)

INPUT_KEYBOARD は、KEYEVENTF_UNICODE フラグを使用することで、手書き認識や音声認識などのキーボード以外の入力方法を、テキスト入力であるかのようにサポートします。KEYEVENTF_UNICODE が指定されている場合、SendInputwParamVK_PACKET とした WM_KEYDOWN メッセージまたは WM_KEYUP メッセージを、フォアグラウンドスレッドのメッセージキューに送信します。GetMessage または PeekMessage がこのメッセージを取得した後、そのメッセージを TranslateMessage に渡すと、wScan で元々指定された Unicode 文字を含む WM_CHAR メッセージがポストされます。この Unicode 文字は、ANSI ウィンドウにポストされる場合、自動的に適切な ANSI 値に変換されます。

スキャンコードによってキーボード入力を定義するには、KEYEVENTF_SCANCODE フラグを設定します。これは、現在どのキーボードが使用されているかにかかわらず、物理的なキーストロークをシミュレートする場合に便利です。スキャンコードが拡張キーの場合は、KEYEVENTF_EXTENDEDKEY フラグを渡すこともできます。キーの仮想キー値は、現在のキーボードレイアウトや同時に押された他のキーによって変わることがありますが、スキャンコードは常に同じです。

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

各言語での定義

#include <windows.h>

// KEYBDINPUT  (x64 24 / x86 16 バイト)
typedef struct KEYBDINPUT {
    VIRTUAL_KEY wVk;
    WORD wScan;
    KEYBD_EVENT_FLAGS dwFlags;
    DWORD time;
    UINT_PTR dwExtraInfo;
} KEYBDINPUT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KEYBDINPUT
{
    public ushort wVk;
    public ushort wScan;
    public uint dwFlags;
    public uint time;
    public UIntPtr dwExtraInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KEYBDINPUT
    Public wVk As UShort
    Public wScan As UShort
    Public dwFlags As UInteger
    Public time As UInteger
    Public dwExtraInfo As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class KEYBDINPUT(ctypes.Structure):
    _fields_ = [
        ("wVk", ctypes.c_ushort),
        ("wScan", ctypes.c_ushort),
        ("dwFlags", wintypes.DWORD),
        ("time", wintypes.DWORD),
        ("dwExtraInfo", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct KEYBDINPUT {
    pub wVk: u16,
    pub wScan: u16,
    pub dwFlags: u32,
    pub time: u32,
    pub dwExtraInfo: usize,
}
import "golang.org/x/sys/windows"

type KEYBDINPUT struct {
	wVk uint16
	wScan uint16
	dwFlags uint32
	time uint32
	dwExtraInfo uintptr
}
type
  KEYBDINPUT = record
    wVk: Word;
    wScan: Word;
    dwFlags: DWORD;
    time: DWORD;
    dwExtraInfo: NativeUInt;
  end;
const KEYBDINPUT = extern struct {
    wVk: u16,
    wScan: u16,
    dwFlags: u32,
    time: u32,
    dwExtraInfo: usize,
};
type
  KEYBDINPUT {.bycopy.} = object
    wVk: uint16
    wScan: uint16
    dwFlags: uint32
    time: uint32
    dwExtraInfo: uint
struct KEYBDINPUT
{
    ushort wVk;
    ushort wScan;
    uint dwFlags;
    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 レイアウト)
; KEYBDINPUT サイズ: 16 バイト(x86)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; wVk : VIRTUAL_KEY (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; wScan : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; dwFlags : KEYBD_EVENT_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; time : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwExtraInfo : UINT_PTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KEYBDINPUT サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; wVk : VIRTUAL_KEY (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; wScan : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; dwFlags : KEYBD_EVENT_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; time : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwExtraInfo : UINT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global KEYBDINPUT
    #field short wVk
    #field short wScan
    #field int dwFlags
    #field int time
    #field intptr dwExtraInfo
#endstruct

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