ホーム › Devices.HumanInterfaceDevice › HidP_TranslateUsagesToI8042ScanCodes

HidP_TranslateUsagesToI8042ScanCodes

関数

HIDキーボードの用途をi8042スキャンコードへ変換する。

DLLHID.dll呼出規約winapi

シグネチャ

// HID.dll
#include <windows.h>

NTSTATUS HidP_TranslateUsagesToI8042ScanCodes(
    WORD* ChangedUsageList,
    DWORD UsageListLength,
    HIDP_KEYBOARD_DIRECTION KeyAction,
    HIDP_KEYBOARD_MODIFIER_STATE* ModifierState,
    PHIDP_INSERT_SCANCODES InsertCodesProcedure,
    void* InsertCodesContext   // optional
);

パラメーター

名前	型	方向
ChangedUsageList	WORD*	in
UsageListLength	DWORD	in
KeyAction	HIDP_KEYBOARD_DIRECTION	in
ModifierState	HIDP_KEYBOARD_MODIFIER_STATE*	inout
InsertCodesProcedure	PHIDP_INSERT_SCANCODES	in
InsertCodesContext	void*	inoptional

戻り値の型: NTSTATUS

各言語での呼び出し定義

// HID.dll
#include <windows.h>

NTSTATUS HidP_TranslateUsagesToI8042ScanCodes(
    WORD* ChangedUsageList,
    DWORD UsageListLength,
    HIDP_KEYBOARD_DIRECTION KeyAction,
    HIDP_KEYBOARD_MODIFIER_STATE* ModifierState,
    PHIDP_INSERT_SCANCODES InsertCodesProcedure,
    void* InsertCodesContext   // optional
);

[DllImport("HID.dll", ExactSpelling = true)]
static extern int HidP_TranslateUsagesToI8042ScanCodes(
    ref ushort ChangedUsageList,   // WORD*
    uint UsageListLength,   // DWORD
    int KeyAction,   // HIDP_KEYBOARD_DIRECTION
    IntPtr ModifierState,   // HIDP_KEYBOARD_MODIFIER_STATE* in/out
    IntPtr InsertCodesProcedure,   // PHIDP_INSERT_SCANCODES
    IntPtr InsertCodesContext   // void* optional
);

<DllImport("HID.dll", ExactSpelling:=True)>
Public Shared Function HidP_TranslateUsagesToI8042ScanCodes(
    ByRef ChangedUsageList As UShort,   ' WORD*
    UsageListLength As UInteger,   ' DWORD
    KeyAction As Integer,   ' HIDP_KEYBOARD_DIRECTION
    ModifierState As IntPtr,   ' HIDP_KEYBOARD_MODIFIER_STATE* in/out
    InsertCodesProcedure As IntPtr,   ' PHIDP_INSERT_SCANCODES
    InsertCodesContext As IntPtr   ' void* optional
) As Integer
End Function

' ChangedUsageList : WORD*
' UsageListLength : DWORD
' KeyAction : HIDP_KEYBOARD_DIRECTION
' ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out
' InsertCodesProcedure : PHIDP_INSERT_SCANCODES
' InsertCodesContext : void* optional
Declare PtrSafe Function HidP_TranslateUsagesToI8042ScanCodes Lib "hid" ( _
    ByRef ChangedUsageList As Integer, _
    ByVal UsageListLength As Long, _
    ByVal KeyAction As Long, _
    ByVal ModifierState As LongPtr, _
    ByVal InsertCodesProcedure As LongPtr, _
    ByVal InsertCodesContext As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

HidP_TranslateUsagesToI8042ScanCodes = ctypes.windll.hid.HidP_TranslateUsagesToI8042ScanCodes
HidP_TranslateUsagesToI8042ScanCodes.restype = ctypes.c_int
HidP_TranslateUsagesToI8042ScanCodes.argtypes = [
    ctypes.POINTER(ctypes.c_ushort),  # ChangedUsageList : WORD*
    wintypes.DWORD,  # UsageListLength : DWORD
    ctypes.c_int,  # KeyAction : HIDP_KEYBOARD_DIRECTION
    ctypes.c_void_p,  # ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out
    ctypes.c_void_p,  # InsertCodesProcedure : PHIDP_INSERT_SCANCODES
    ctypes.POINTER(None),  # InsertCodesContext : void* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('HID.dll')
HidP_TranslateUsagesToI8042ScanCodes = Fiddle::Function.new(
  lib['HidP_TranslateUsagesToI8042ScanCodes'],
  [
    Fiddle::TYPE_VOIDP,  # ChangedUsageList : WORD*
    -Fiddle::TYPE_INT,  # UsageListLength : DWORD
    Fiddle::TYPE_INT,  # KeyAction : HIDP_KEYBOARD_DIRECTION
    Fiddle::TYPE_VOIDP,  # ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out
    Fiddle::TYPE_VOIDP,  # InsertCodesProcedure : PHIDP_INSERT_SCANCODES
    Fiddle::TYPE_VOIDP,  # InsertCodesContext : void* optional
  ],
  Fiddle::TYPE_INT)

#[link(name = "hid")]
extern "system" {
    fn HidP_TranslateUsagesToI8042ScanCodes(
        ChangedUsageList: *mut u16,  // WORD*
        UsageListLength: u32,  // DWORD
        KeyAction: i32,  // HIDP_KEYBOARD_DIRECTION
        ModifierState: *mut HIDP_KEYBOARD_MODIFIER_STATE,  // HIDP_KEYBOARD_MODIFIER_STATE* in/out
        InsertCodesProcedure: *const core::ffi::c_void,  // PHIDP_INSERT_SCANCODES
        InsertCodesContext: *mut ()  // void* optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("HID.dll")]
public static extern int HidP_TranslateUsagesToI8042ScanCodes(ref ushort ChangedUsageList, uint UsageListLength, int KeyAction, IntPtr ModifierState, IntPtr InsertCodesProcedure, IntPtr InsertCodesContext);
"@
$api = Add-Type -MemberDefinition $sig -Name 'HID_HidP_TranslateUsagesToI8042ScanCodes' -Namespace Win32 -PassThru
# $api::HidP_TranslateUsagesToI8042ScanCodes(ChangedUsageList, UsageListLength, KeyAction, ModifierState, InsertCodesProcedure, InsertCodesContext)

#uselib "HID.dll"
#func global HidP_TranslateUsagesToI8042ScanCodes "HidP_TranslateUsagesToI8042ScanCodes" sptr, sptr, sptr, sptr, sptr, sptr
; HidP_TranslateUsagesToI8042ScanCodes varptr(ChangedUsageList), UsageListLength, KeyAction, varptr(ModifierState), InsertCodesProcedure, InsertCodesContext   ; 戻り値は stat
; ChangedUsageList : WORD* -> "sptr"
; UsageListLength : DWORD -> "sptr"
; KeyAction : HIDP_KEYBOARD_DIRECTION -> "sptr"
; ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out -> "sptr"
; InsertCodesProcedure : PHIDP_INSERT_SCANCODES -> "sptr"
; InsertCodesContext : void* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "HID.dll"
#cfunc global HidP_TranslateUsagesToI8042ScanCodes "HidP_TranslateUsagesToI8042ScanCodes" var, int, int, var, sptr, sptr
; res = HidP_TranslateUsagesToI8042ScanCodes(ChangedUsageList, UsageListLength, KeyAction, ModifierState, InsertCodesProcedure, InsertCodesContext)
; ChangedUsageList : WORD* -> "var"
; UsageListLength : DWORD -> "int"
; KeyAction : HIDP_KEYBOARD_DIRECTION -> "int"
; ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out -> "var"
; InsertCodesProcedure : PHIDP_INSERT_SCANCODES -> "sptr"
; InsertCodesContext : void* optional -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "HID.dll"
#cfunc global HidP_TranslateUsagesToI8042ScanCodes "HidP_TranslateUsagesToI8042ScanCodes" sptr, int, int, sptr, sptr, sptr
; res = HidP_TranslateUsagesToI8042ScanCodes(varptr(ChangedUsageList), UsageListLength, KeyAction, varptr(ModifierState), InsertCodesProcedure, InsertCodesContext)
; ChangedUsageList : WORD* -> "sptr"
; UsageListLength : DWORD -> "int"
; KeyAction : HIDP_KEYBOARD_DIRECTION -> "int"
; ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out -> "sptr"
; InsertCodesProcedure : PHIDP_INSERT_SCANCODES -> "sptr"
; InsertCodesContext : void* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; NTSTATUS HidP_TranslateUsagesToI8042ScanCodes(WORD* ChangedUsageList, DWORD UsageListLength, HIDP_KEYBOARD_DIRECTION KeyAction, HIDP_KEYBOARD_MODIFIER_STATE* ModifierState, PHIDP_INSERT_SCANCODES InsertCodesProcedure, void* InsertCodesContext)
#uselib "HID.dll"
#cfunc global HidP_TranslateUsagesToI8042ScanCodes "HidP_TranslateUsagesToI8042ScanCodes" var, int, int, var, intptr, intptr
; res = HidP_TranslateUsagesToI8042ScanCodes(ChangedUsageList, UsageListLength, KeyAction, ModifierState, InsertCodesProcedure, InsertCodesContext)
; ChangedUsageList : WORD* -> "var"
; UsageListLength : DWORD -> "int"
; KeyAction : HIDP_KEYBOARD_DIRECTION -> "int"
; ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out -> "var"
; InsertCodesProcedure : PHIDP_INSERT_SCANCODES -> "intptr"
; InsertCodesContext : void* optional -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; NTSTATUS HidP_TranslateUsagesToI8042ScanCodes(WORD* ChangedUsageList, DWORD UsageListLength, HIDP_KEYBOARD_DIRECTION KeyAction, HIDP_KEYBOARD_MODIFIER_STATE* ModifierState, PHIDP_INSERT_SCANCODES InsertCodesProcedure, void* InsertCodesContext)
#uselib "HID.dll"
#cfunc global HidP_TranslateUsagesToI8042ScanCodes "HidP_TranslateUsagesToI8042ScanCodes" intptr, int, int, intptr, intptr, intptr
; res = HidP_TranslateUsagesToI8042ScanCodes(varptr(ChangedUsageList), UsageListLength, KeyAction, varptr(ModifierState), InsertCodesProcedure, InsertCodesContext)
; ChangedUsageList : WORD* -> "intptr"
; UsageListLength : DWORD -> "int"
; KeyAction : HIDP_KEYBOARD_DIRECTION -> "int"
; ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out -> "intptr"
; InsertCodesProcedure : PHIDP_INSERT_SCANCODES -> "intptr"
; InsertCodesContext : void* optional -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	hid = windows.NewLazySystemDLL("HID.dll")
	procHidP_TranslateUsagesToI8042ScanCodes = hid.NewProc("HidP_TranslateUsagesToI8042ScanCodes")
)

// ChangedUsageList (WORD*), UsageListLength (DWORD), KeyAction (HIDP_KEYBOARD_DIRECTION), ModifierState (HIDP_KEYBOARD_MODIFIER_STATE* in/out), InsertCodesProcedure (PHIDP_INSERT_SCANCODES), InsertCodesContext (void* optional)
r1, _, err := procHidP_TranslateUsagesToI8042ScanCodes.Call(
	uintptr(ChangedUsageList),
	uintptr(UsageListLength),
	uintptr(KeyAction),
	uintptr(ModifierState),
	uintptr(InsertCodesProcedure),
	uintptr(InsertCodesContext),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // NTSTATUS

function HidP_TranslateUsagesToI8042ScanCodes(
  ChangedUsageList: Pointer;   // WORD*
  UsageListLength: DWORD;   // DWORD
  KeyAction: Integer;   // HIDP_KEYBOARD_DIRECTION
  ModifierState: Pointer;   // HIDP_KEYBOARD_MODIFIER_STATE* in/out
  InsertCodesProcedure: Pointer;   // PHIDP_INSERT_SCANCODES
  InsertCodesContext: Pointer   // void* optional
): Integer; stdcall;
  external 'HID.dll' name 'HidP_TranslateUsagesToI8042ScanCodes';

result := DllCall("HID\HidP_TranslateUsagesToI8042ScanCodes"
    , "Ptr", ChangedUsageList   ; WORD*
    , "UInt", UsageListLength   ; DWORD
    , "Int", KeyAction   ; HIDP_KEYBOARD_DIRECTION
    , "Ptr", ModifierState   ; HIDP_KEYBOARD_MODIFIER_STATE* in/out
    , "Ptr", InsertCodesProcedure   ; PHIDP_INSERT_SCANCODES
    , "Ptr", InsertCodesContext   ; void* optional
    , "Int")   ; return: NTSTATUS

●HidP_TranslateUsagesToI8042ScanCodes(ChangedUsageList, UsageListLength, KeyAction, ModifierState, InsertCodesProcedure, InsertCodesContext) = DLL("HID.dll", "int HidP_TranslateUsagesToI8042ScanCodes(void*, dword, int, void*, void*, void*)")
# 呼び出し: HidP_TranslateUsagesToI8042ScanCodes(ChangedUsageList, UsageListLength, KeyAction, ModifierState, InsertCodesProcedure, InsertCodesContext)
# ChangedUsageList : WORD* -> "void*"
# UsageListLength : DWORD -> "dword"
# KeyAction : HIDP_KEYBOARD_DIRECTION -> "int"
# ModifierState : HIDP_KEYBOARD_MODIFIER_STATE* in/out -> "void*"
# InsertCodesProcedure : PHIDP_INSERT_SCANCODES -> "void*"
# InsertCodesContext : void* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。