ホーム › Devices.HumanInterfaceDevice › HidP_SetButtonArray
HidP_SetButtonArray
関数HIDレポートにボタン配列コントロールのデータを設定する。
シグネチャ
// HID.dll
#include <windows.h>
NTSTATUS HidP_SetButtonArray(
HIDP_REPORT_TYPE ReportType,
WORD UsagePage,
WORD LinkCollection, // optional
WORD Usage,
HIDP_BUTTON_ARRAY_DATA* ButtonData,
WORD ButtonDataLength,
PHIDP_PREPARSED_DATA PreparsedData,
LPSTR Report,
DWORD ReportLength
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| ReportType | HIDP_REPORT_TYPE | in |
| UsagePage | WORD | in |
| LinkCollection | WORD | inoptional |
| Usage | WORD | in |
| ButtonData | HIDP_BUTTON_ARRAY_DATA* | in |
| ButtonDataLength | WORD | in |
| PreparsedData | PHIDP_PREPARSED_DATA | in |
| Report | LPSTR | inout |
| ReportLength | DWORD | in |
戻り値の型: NTSTATUS
各言語での呼び出し定義
// HID.dll
#include <windows.h>
NTSTATUS HidP_SetButtonArray(
HIDP_REPORT_TYPE ReportType,
WORD UsagePage,
WORD LinkCollection, // optional
WORD Usage,
HIDP_BUTTON_ARRAY_DATA* ButtonData,
WORD ButtonDataLength,
PHIDP_PREPARSED_DATA PreparsedData,
LPSTR Report,
DWORD ReportLength
);[DllImport("HID.dll", ExactSpelling = true)]
static extern int HidP_SetButtonArray(
int ReportType, // HIDP_REPORT_TYPE
ushort UsagePage, // WORD
ushort LinkCollection, // WORD optional
ushort Usage, // WORD
IntPtr ButtonData, // HIDP_BUTTON_ARRAY_DATA*
ushort ButtonDataLength, // WORD
IntPtr PreparsedData, // PHIDP_PREPARSED_DATA
[MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder Report, // LPSTR in/out
uint ReportLength // DWORD
);<DllImport("HID.dll", ExactSpelling:=True)>
Public Shared Function HidP_SetButtonArray(
ReportType As Integer, ' HIDP_REPORT_TYPE
UsagePage As UShort, ' WORD
LinkCollection As UShort, ' WORD optional
Usage As UShort, ' WORD
ButtonData As IntPtr, ' HIDP_BUTTON_ARRAY_DATA*
ButtonDataLength As UShort, ' WORD
PreparsedData As IntPtr, ' PHIDP_PREPARSED_DATA
<MarshalAs(UnmanagedType.LPStr)> Report As System.Text.StringBuilder, ' LPSTR in/out
ReportLength As UInteger ' DWORD
) As Integer
End Function' ReportType : HIDP_REPORT_TYPE
' UsagePage : WORD
' LinkCollection : WORD optional
' Usage : WORD
' ButtonData : HIDP_BUTTON_ARRAY_DATA*
' ButtonDataLength : WORD
' PreparsedData : PHIDP_PREPARSED_DATA
' Report : LPSTR in/out
' ReportLength : DWORD
Declare PtrSafe Function HidP_SetButtonArray Lib "hid" ( _
ByVal ReportType As Long, _
ByVal UsagePage As Integer, _
ByVal LinkCollection As Integer, _
ByVal Usage As Integer, _
ByVal ButtonData As LongPtr, _
ByVal ButtonDataLength As Integer, _
ByVal PreparsedData As LongPtr, _
ByVal Report As String, _
ByVal ReportLength As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
HidP_SetButtonArray = ctypes.windll.hid.HidP_SetButtonArray
HidP_SetButtonArray.restype = ctypes.c_int
HidP_SetButtonArray.argtypes = [
ctypes.c_int, # ReportType : HIDP_REPORT_TYPE
ctypes.c_ushort, # UsagePage : WORD
ctypes.c_ushort, # LinkCollection : WORD optional
ctypes.c_ushort, # Usage : WORD
ctypes.c_void_p, # ButtonData : HIDP_BUTTON_ARRAY_DATA*
ctypes.c_ushort, # ButtonDataLength : WORD
ctypes.c_ssize_t, # PreparsedData : PHIDP_PREPARSED_DATA
wintypes.LPSTR, # Report : LPSTR in/out
wintypes.DWORD, # ReportLength : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('HID.dll')
HidP_SetButtonArray = Fiddle::Function.new(
lib['HidP_SetButtonArray'],
[
Fiddle::TYPE_INT, # ReportType : HIDP_REPORT_TYPE
-Fiddle::TYPE_SHORT, # UsagePage : WORD
-Fiddle::TYPE_SHORT, # LinkCollection : WORD optional
-Fiddle::TYPE_SHORT, # Usage : WORD
Fiddle::TYPE_VOIDP, # ButtonData : HIDP_BUTTON_ARRAY_DATA*
-Fiddle::TYPE_SHORT, # ButtonDataLength : WORD
Fiddle::TYPE_INTPTR_T, # PreparsedData : PHIDP_PREPARSED_DATA
Fiddle::TYPE_VOIDP, # Report : LPSTR in/out
-Fiddle::TYPE_INT, # ReportLength : DWORD
],
Fiddle::TYPE_INT)#[link(name = "hid")]
extern "system" {
fn HidP_SetButtonArray(
ReportType: i32, // HIDP_REPORT_TYPE
UsagePage: u16, // WORD
LinkCollection: u16, // WORD optional
Usage: u16, // WORD
ButtonData: *mut HIDP_BUTTON_ARRAY_DATA, // HIDP_BUTTON_ARRAY_DATA*
ButtonDataLength: u16, // WORD
PreparsedData: isize, // PHIDP_PREPARSED_DATA
Report: *mut u8, // LPSTR in/out
ReportLength: u32 // DWORD
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("HID.dll")]
public static extern int HidP_SetButtonArray(int ReportType, ushort UsagePage, ushort LinkCollection, ushort Usage, IntPtr ButtonData, ushort ButtonDataLength, IntPtr PreparsedData, [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder Report, uint ReportLength);
"@
$api = Add-Type -MemberDefinition $sig -Name 'HID_HidP_SetButtonArray' -Namespace Win32 -PassThru
# $api::HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, ButtonData, ButtonDataLength, PreparsedData, Report, ReportLength)#uselib "HID.dll"
#func global HidP_SetButtonArray "HidP_SetButtonArray" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; HidP_SetButtonArray ReportType, UsagePage, LinkCollection, Usage, varptr(ButtonData), ButtonDataLength, PreparsedData, varptr(Report), ReportLength ; 戻り値は stat
; ReportType : HIDP_REPORT_TYPE -> "sptr"
; UsagePage : WORD -> "sptr"
; LinkCollection : WORD optional -> "sptr"
; Usage : WORD -> "sptr"
; ButtonData : HIDP_BUTTON_ARRAY_DATA* -> "sptr"
; ButtonDataLength : WORD -> "sptr"
; PreparsedData : PHIDP_PREPARSED_DATA -> "sptr"
; Report : LPSTR in/out -> "sptr"
; ReportLength : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "HID.dll" #cfunc global HidP_SetButtonArray "HidP_SetButtonArray" int, int, int, int, var, int, sptr, var, int ; res = HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, ButtonData, ButtonDataLength, PreparsedData, Report, ReportLength) ; ReportType : HIDP_REPORT_TYPE -> "int" ; UsagePage : WORD -> "int" ; LinkCollection : WORD optional -> "int" ; Usage : WORD -> "int" ; ButtonData : HIDP_BUTTON_ARRAY_DATA* -> "var" ; ButtonDataLength : WORD -> "int" ; PreparsedData : PHIDP_PREPARSED_DATA -> "sptr" ; Report : LPSTR in/out -> "var" ; ReportLength : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "HID.dll" #cfunc global HidP_SetButtonArray "HidP_SetButtonArray" int, int, int, int, sptr, int, sptr, sptr, int ; res = HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, varptr(ButtonData), ButtonDataLength, PreparsedData, varptr(Report), ReportLength) ; ReportType : HIDP_REPORT_TYPE -> "int" ; UsagePage : WORD -> "int" ; LinkCollection : WORD optional -> "int" ; Usage : WORD -> "int" ; ButtonData : HIDP_BUTTON_ARRAY_DATA* -> "sptr" ; ButtonDataLength : WORD -> "int" ; PreparsedData : PHIDP_PREPARSED_DATA -> "sptr" ; Report : LPSTR in/out -> "sptr" ; ReportLength : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; NTSTATUS HidP_SetButtonArray(HIDP_REPORT_TYPE ReportType, WORD UsagePage, WORD LinkCollection, WORD Usage, HIDP_BUTTON_ARRAY_DATA* ButtonData, WORD ButtonDataLength, PHIDP_PREPARSED_DATA PreparsedData, LPSTR Report, DWORD ReportLength) #uselib "HID.dll" #cfunc global HidP_SetButtonArray "HidP_SetButtonArray" int, int, int, int, var, int, intptr, var, int ; res = HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, ButtonData, ButtonDataLength, PreparsedData, Report, ReportLength) ; ReportType : HIDP_REPORT_TYPE -> "int" ; UsagePage : WORD -> "int" ; LinkCollection : WORD optional -> "int" ; Usage : WORD -> "int" ; ButtonData : HIDP_BUTTON_ARRAY_DATA* -> "var" ; ButtonDataLength : WORD -> "int" ; PreparsedData : PHIDP_PREPARSED_DATA -> "intptr" ; Report : LPSTR in/out -> "var" ; ReportLength : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; NTSTATUS HidP_SetButtonArray(HIDP_REPORT_TYPE ReportType, WORD UsagePage, WORD LinkCollection, WORD Usage, HIDP_BUTTON_ARRAY_DATA* ButtonData, WORD ButtonDataLength, PHIDP_PREPARSED_DATA PreparsedData, LPSTR Report, DWORD ReportLength) #uselib "HID.dll" #cfunc global HidP_SetButtonArray "HidP_SetButtonArray" int, int, int, int, intptr, int, intptr, intptr, int ; res = HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, varptr(ButtonData), ButtonDataLength, PreparsedData, varptr(Report), ReportLength) ; ReportType : HIDP_REPORT_TYPE -> "int" ; UsagePage : WORD -> "int" ; LinkCollection : WORD optional -> "int" ; Usage : WORD -> "int" ; ButtonData : HIDP_BUTTON_ARRAY_DATA* -> "intptr" ; ButtonDataLength : WORD -> "int" ; PreparsedData : PHIDP_PREPARSED_DATA -> "intptr" ; Report : LPSTR in/out -> "intptr" ; ReportLength : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
hid = windows.NewLazySystemDLL("HID.dll")
procHidP_SetButtonArray = hid.NewProc("HidP_SetButtonArray")
)
// ReportType (HIDP_REPORT_TYPE), UsagePage (WORD), LinkCollection (WORD optional), Usage (WORD), ButtonData (HIDP_BUTTON_ARRAY_DATA*), ButtonDataLength (WORD), PreparsedData (PHIDP_PREPARSED_DATA), Report (LPSTR in/out), ReportLength (DWORD)
r1, _, err := procHidP_SetButtonArray.Call(
uintptr(ReportType),
uintptr(UsagePage),
uintptr(LinkCollection),
uintptr(Usage),
uintptr(ButtonData),
uintptr(ButtonDataLength),
uintptr(PreparsedData),
uintptr(Report),
uintptr(ReportLength),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // NTSTATUSfunction HidP_SetButtonArray(
ReportType: Integer; // HIDP_REPORT_TYPE
UsagePage: Word; // WORD
LinkCollection: Word; // WORD optional
Usage: Word; // WORD
ButtonData: Pointer; // HIDP_BUTTON_ARRAY_DATA*
ButtonDataLength: Word; // WORD
PreparsedData: NativeInt; // PHIDP_PREPARSED_DATA
Report: PAnsiChar; // LPSTR in/out
ReportLength: DWORD // DWORD
): Integer; stdcall;
external 'HID.dll' name 'HidP_SetButtonArray';result := DllCall("HID\HidP_SetButtonArray"
, "Int", ReportType ; HIDP_REPORT_TYPE
, "UShort", UsagePage ; WORD
, "UShort", LinkCollection ; WORD optional
, "UShort", Usage ; WORD
, "Ptr", ButtonData ; HIDP_BUTTON_ARRAY_DATA*
, "UShort", ButtonDataLength ; WORD
, "Ptr", PreparsedData ; PHIDP_PREPARSED_DATA
, "Ptr", Report ; LPSTR in/out
, "UInt", ReportLength ; DWORD
, "Int") ; return: NTSTATUS●HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, ButtonData, ButtonDataLength, PreparsedData, Report, ReportLength) = DLL("HID.dll", "int HidP_SetButtonArray(int, int, int, int, void*, int, int, char*, dword)")
# 呼び出し: HidP_SetButtonArray(ReportType, UsagePage, LinkCollection, Usage, ButtonData, ButtonDataLength, PreparsedData, Report, ReportLength)
# ReportType : HIDP_REPORT_TYPE -> "int"
# UsagePage : WORD -> "int"
# LinkCollection : WORD optional -> "int"
# Usage : WORD -> "int"
# ButtonData : HIDP_BUTTON_ARRAY_DATA* -> "void*"
# ButtonDataLength : WORD -> "int"
# PreparsedData : PHIDP_PREPARSED_DATA -> "int"
# Report : LPSTR in/out -> "char*"
# ReportLength : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。