Win32 API 日本語リファレンス
ホームDevices.DeviceAndDriverInstallation › SP_DEVINSTALL_PARAMS_A

SP_DEVINSTALL_PARAMS_A

構造体
サイズx64: 316 バイト / x86: 296 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のバイト単位サイズ。呼び出し前に設定する。
FlagsSETUP_DI_DEVICE_INSTALL_FLAGS4+4+4デバイスインストール動作を制御するフラグ群(SETUP_DI_DEVICE_INSTALL_FLAGS)。
FlagsExSETUP_DI_DEVICE_INSTALL_FLAGS_EX4+8+8拡張インストール制御フラグ群(SETUP_DI_DEVICE_INSTALL_FLAGS_EX)。
hwndParentHWND8/4+12+12UIの親ウィンドウハンドル。UI不要ならNULL。
InstallMsgHandlerPSP_FILE_CALLBACK_A8/4+20+16ファイルコピー進捗等を受け取るコールバック関数(ANSI)。NULL可。
InstallMsgHandlerContextvoid*8/4+28+20コールバックに渡すユーザー定義コンテキストへのポインタ。
FileQueuevoid*8/4+36+24操作を登録するファイルキューのハンドル。NULL可。
ClassInstallReservedUINT_PTR8/4+44+28クラスインストーラ用予約領域。
ReservedDWORD4+52+32システム内部利用の予約領域。0を設定する。
DriverPathCHAR260+56+36ドライバ検索パス(ANSI)を格納する固定長バッファ。

各言語での定義

#include <windows.h>

// SP_DEVINSTALL_PARAMS_A  (x64 316 / x86 296 バイト)
#pragma pack(push, 1)
typedef struct SP_DEVINSTALL_PARAMS_A {
    DWORD cbSize;
    SETUP_DI_DEVICE_INSTALL_FLAGS Flags;
    SETUP_DI_DEVICE_INSTALL_FLAGS_EX FlagsEx;
    HWND hwndParent;
    PSP_FILE_CALLBACK_A InstallMsgHandler;
    void* InstallMsgHandlerContext;
    void* FileQueue;
    UINT_PTR ClassInstallReserved;
    DWORD Reserved;
    CHAR DriverPath[260];
} SP_DEVINSTALL_PARAMS_A;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct SP_DEVINSTALL_PARAMS_A
{
    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.ByValArray, SizeConst = 260)] public sbyte[] DriverPath;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure SP_DEVINSTALL_PARAMS_A
    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.ByValArray, SizeConst:=260)> Public DriverPath() As SByte
End Structure
import ctypes
from ctypes import wintypes

class SP_DEVINSTALL_PARAMS_A(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_byte * 260),
    ]
#[repr(C, packed(1))]
pub struct SP_DEVINSTALL_PARAMS_A {
    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: [i8; 260],
}
import "golang.org/x/sys/windows"

type SP_DEVINSTALL_PARAMS_A struct {
	cbSize uint32
	Flags uint32
	FlagsEx uint32
	hwndParent uintptr
	InstallMsgHandler uintptr
	InstallMsgHandlerContext uintptr
	FileQueue uintptr
	ClassInstallReserved uintptr
	Reserved uint32
	DriverPath [260]int8
}
type
  SP_DEVINSTALL_PARAMS_A = 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 Shortint;
  end;
const SP_DEVINSTALL_PARAMS_A = extern struct {
    cbSize: u32,
    Flags: u32,
    FlagsEx: u32,
    hwndParent: ?*anyopaque,
    InstallMsgHandler: ?*anyopaque,
    InstallMsgHandlerContext: ?*anyopaque,
    FileQueue: ?*anyopaque,
    ClassInstallReserved: usize,
    Reserved: u32,
    DriverPath: [260]i8,
};
type
  SP_DEVINSTALL_PARAMS_A {.packed.} = object
    cbSize: uint32
    Flags: uint32
    FlagsEx: uint32
    hwndParent: pointer
    InstallMsgHandler: pointer
    InstallMsgHandlerContext: pointer
    FileQueue: pointer
    ClassInstallReserved: uint
    Reserved: uint32
    DriverPath: array[260, int8]
align(1)
struct SP_DEVINSTALL_PARAMS_A
{
    uint cbSize;
    uint Flags;
    uint FlagsEx;
    void* hwndParent;
    void* InstallMsgHandler;
    void* InstallMsgHandlerContext;
    void* FileQueue;
    size_t ClassInstallReserved;
    uint Reserved;
    byte[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_A サイズ: 296 バイト(x86)
dim st, 74    ; 4byte整数×74(構造体サイズ 296 / 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_A (+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 : CHAR (+36, 260byte)  varptr(st)+36 を基点に操作(260byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SP_DEVINSTALL_PARAMS_A サイズ: 316 バイト(x64)
dim st, 79    ; 4byte整数×79(構造体サイズ 316 / 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_A (+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 : CHAR (+56, 260byte)  varptr(st)+56 を基点に操作(260byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SP_DEVINSTALL_PARAMS_A, 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 byte DriverPath 260
#endstruct

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