ホーム › Devices.DeviceAndDriverInstallation › SP_DEVINSTALL_PARAMS_W

SP_DEVINSTALL_PARAMS_W

構造体

サイズx64: 576 バイト / x86: 556 バイトパッキング1

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

フィールド

フィールド	型	サイズ	x64	x86	説明
cbSize	DWORD	4	+0	+0	この構造体のバイト単位サイズ。呼び出し前に設定する。
Flags	SETUP_DI_DEVICE_INSTALL_FLAGS	4	+4	+4	デバイスインストール動作を制御するフラグ群(SETUP_DI_DEVICE_INSTALL_FLAGS)。
FlagsEx	SETUP_DI_DEVICE_INSTALL_FLAGS_EX	4	+8	+8	拡張インストール制御フラグ群(SETUP_DI_DEVICE_INSTALL_FLAGS_EX)。
hwndParent	HWND	8/4	+12	+12	UIの親ウィンドウハンドル。UI不要ならNULL。
InstallMsgHandler	PSP_FILE_CALLBACK_W	8/4	+20	+16	ファイルコピー進捗等を受け取るコールバック関数(Unicode)。NULL可。
InstallMsgHandlerContext	void*	8/4	+28	+20	コールバックに渡すユーザー定義コンテキストへのポインタ。
FileQueue	void*	8/4	+36	+24	操作を登録するファイルキューのハンドル。NULL可。
ClassInstallReserved	UINT_PTR	8/4	+44	+28	クラスインストーラ用予約領域。
Reserved	DWORD	4	+52	+32	システム内部利用の予約領域。0を設定する。
DriverPath	WCHAR	520	+56	+36	ドライバ検索パス(Unicode)を格納する固定長バッファ。

各言語での定義

#include <windows.h>

// SP_DEVINSTALL_PARAMS_W  (x64 576 / x86 556 バイト)
#pragma pack(push, 1)
typedef struct SP_DEVINSTALL_PARAMS_W {
    DWORD cbSize;
    SETUP_DI_DEVICE_INSTALL_FLAGS Flags;
    SETUP_DI_DEVICE_INSTALL_FLAGS_EX FlagsEx;
    HWND hwndParent;
    PSP_FILE_CALLBACK_W InstallMsgHandler;
    void* InstallMsgHandlerContext;
    void* FileQueue;
    UINT_PTR ClassInstallReserved;
    DWORD Reserved;
    WCHAR DriverPath[260];
} SP_DEVINSTALL_PARAMS_W;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct SP_DEVINSTALL_PARAMS_W
{
    public uint cbSize;
    public uint Flags;
    public uint FlagsEx;
    public IntPtr hwndParent;
    public IntPtr InstallMsgHandler;
    public IntPtr InstallMsgHandlerContext;
    public IntPtr FileQueue;
    public UIntPtr ClassInstallReserved;
    public uint Reserved;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string DriverPath;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure SP_DEVINSTALL_PARAMS_W
    Public cbSize As UInteger
    Public Flags As UInteger
    Public FlagsEx As UInteger
    Public hwndParent As IntPtr
    Public InstallMsgHandler As IntPtr
    Public InstallMsgHandlerContext As IntPtr
    Public FileQueue As IntPtr
    Public ClassInstallReserved As UIntPtr
    Public Reserved As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public DriverPath As String
End Structure

import ctypes
from ctypes import wintypes

class SP_DEVINSTALL_PARAMS_W(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("Flags", wintypes.DWORD),
        ("FlagsEx", wintypes.DWORD),
        ("hwndParent", ctypes.c_void_p),
        ("InstallMsgHandler", ctypes.c_void_p),
        ("InstallMsgHandlerContext", ctypes.c_void_p),
        ("FileQueue", ctypes.c_void_p),
        ("ClassInstallReserved", ctypes.c_size_t),
        ("Reserved", wintypes.DWORD),
        ("DriverPath", ctypes.c_wchar * 260),
    ]

#[repr(C, packed(1))]
pub struct SP_DEVINSTALL_PARAMS_W {
    pub cbSize: u32,
    pub Flags: u32,
    pub FlagsEx: u32,
    pub hwndParent: *mut core::ffi::c_void,
    pub InstallMsgHandler: *mut core::ffi::c_void,
    pub InstallMsgHandlerContext: *mut core::ffi::c_void,
    pub FileQueue: *mut core::ffi::c_void,
    pub ClassInstallReserved: usize,
    pub Reserved: u32,
    pub DriverPath: [u16; 260],
}

import "golang.org/x/sys/windows"

type SP_DEVINSTALL_PARAMS_W struct {
	cbSize uint32
	Flags uint32
	FlagsEx uint32
	hwndParent uintptr
	InstallMsgHandler uintptr
	InstallMsgHandlerContext uintptr
	FileQueue uintptr
	ClassInstallReserved uintptr
	Reserved uint32
	DriverPath [260]uint16
}

type
  SP_DEVINSTALL_PARAMS_W = packed record
    cbSize: DWORD;
    Flags: DWORD;
    FlagsEx: DWORD;
    hwndParent: Pointer;
    InstallMsgHandler: Pointer;
    InstallMsgHandlerContext: Pointer;
    FileQueue: Pointer;
    ClassInstallReserved: NativeUInt;
    Reserved: DWORD;
    DriverPath: array[0..259] of WideChar;
  end;

const SP_DEVINSTALL_PARAMS_W = extern struct {
    cbSize: u32,
    Flags: u32,
    FlagsEx: u32,
    hwndParent: ?*anyopaque,
    InstallMsgHandler: ?*anyopaque,
    InstallMsgHandlerContext: ?*anyopaque,
    FileQueue: ?*anyopaque,
    ClassInstallReserved: usize,
    Reserved: u32,
    DriverPath: [260]u16,
};

type
  SP_DEVINSTALL_PARAMS_W {.packed.} = object
    cbSize: uint32
    Flags: uint32
    FlagsEx: uint32
    hwndParent: pointer
    InstallMsgHandler: pointer
    InstallMsgHandlerContext: pointer
    FileQueue: pointer
    ClassInstallReserved: uint
    Reserved: uint32
    DriverPath: array[260, uint16]

align(1)
struct SP_DEVINSTALL_PARAMS_W
{
    uint cbSize;
    uint Flags;
    uint FlagsEx;
    void* hwndParent;
    void* InstallMsgHandler;
    void* InstallMsgHandlerContext;
    void* FileQueue;
    size_t ClassInstallReserved;
    uint Reserved;
    wchar[260] DriverPath;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SP_DEVINSTALL_PARAMS_W サイズ: 556 バイト(x86)
dim st, 139    ; 4byte整数×139(構造体サイズ 556 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Flags : SETUP_DI_DEVICE_INSTALL_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; FlagsEx : SETUP_DI_DEVICE_INSTALL_FLAGS_EX (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; hwndParent : HWND (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; InstallMsgHandler : PSP_FILE_CALLBACK_W (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; InstallMsgHandlerContext : void* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; FileQueue : void* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ClassInstallReserved : UINT_PTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Reserved : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; DriverPath : WCHAR (+36, 520byte)  varptr(st)+36 を基点に操作(520byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SP_DEVINSTALL_PARAMS_W サイズ: 576 バイト(x64)
dim st, 144    ; 4byte整数×144(構造体サイズ 576 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Flags : SETUP_DI_DEVICE_INSTALL_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; FlagsEx : SETUP_DI_DEVICE_INSTALL_FLAGS_EX (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; hwndParent : HWND (+12, 8byte)  qpoke st,12,値 / qpeek(st,12)  ※IronHSPのみ。3.7/3.8は lpoke st,12,下位 : lpoke st,16,上位
; InstallMsgHandler : PSP_FILE_CALLBACK_W (+20, 8byte)  qpoke st,20,値 / qpeek(st,20)  ※IronHSPのみ。3.7/3.8は lpoke st,20,下位 : lpoke st,24,上位
; InstallMsgHandlerContext : void* (+28, 8byte)  qpoke st,28,値 / qpeek(st,28)  ※IronHSPのみ。3.7/3.8は lpoke st,28,下位 : lpoke st,32,上位
; FileQueue : void* (+36, 8byte)  qpoke st,36,値 / qpeek(st,36)  ※IronHSPのみ。3.7/3.8は lpoke st,36,下位 : lpoke st,40,上位
; ClassInstallReserved : UINT_PTR (+44, 8byte)  qpoke st,44,値 / qpeek(st,44)  ※IronHSPのみ。3.7/3.8は lpoke st,44,下位 : lpoke st,48,上位
; Reserved : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; DriverPath : WCHAR (+56, 520byte)  varptr(st)+56 を基点に操作(520byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SP_DEVINSTALL_PARAMS_W, pack=1
    #field int cbSize
    #field int Flags
    #field int FlagsEx
    #field intptr hwndParent
    #field intptr InstallMsgHandler
    #field intptr InstallMsgHandlerContext
    #field intptr FileQueue
    #field intptr ClassInstallReserved
    #field int Reserved
    #field wchar DriverPath 260
#endstruct

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

SP_DEVINSTALL_PARAMS_W

フィールド

各言語での定義

HSP用 定義

HSP用定義