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

SP_INSTALLWIZARD_DATA

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

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

フィールド

フィールド型サイズx64x86説明
ClassInstallHeaderSP_CLASSINSTALL_HEADER8+0+0クラスインストール要求の共通ヘッダ(SP_CLASSINSTALL_HEADER)。
FlagsDWORD4+8+8インストールウィザードの動作を制御するフラグ群。
DynamicPagesHPROPSHEETPAGE160/80+12+12動的に追加されるプロパティシートページのハンドル配列。
NumDynamicPagesDWORD4+172+92DynamicPagesに設定されたページ数。
DynamicPageFlagsDWORD4+176+96動的ページに関するフラグ群。
PrivateFlagsDWORD4+180+100クラスインストーラ用の私的フラグ群。
PrivateDataLPARAM8/4+184+104クラスインストーラが利用する私的データ(LPARAM)。
hwndWizardDlgHWND8/4+192+108ウィザードダイアログのウィンドウハンドル。

各言語での定義

#include <windows.h>

// SP_CLASSINSTALL_HEADER  (x64 8 / x86 8 バイト)
typedef struct SP_CLASSINSTALL_HEADER {
    DWORD cbSize;
    DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER;

// SP_INSTALLWIZARD_DATA  (x64 200 / x86 112 バイト)
#pragma pack(push, 1)
typedef struct SP_INSTALLWIZARD_DATA {
    SP_CLASSINSTALL_HEADER ClassInstallHeader;
    DWORD Flags;
    HPROPSHEETPAGE DynamicPages[20];
    DWORD NumDynamicPages;
    DWORD DynamicPageFlags;
    DWORD PrivateFlags;
    LPARAM PrivateData;
    HWND hwndWizardDlg;
} SP_INSTALLWIZARD_DATA;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SP_CLASSINSTALL_HEADER
{
    public uint cbSize;
    public uint InstallFunction;
}

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct SP_INSTALLWIZARD_DATA
{
    public SP_CLASSINSTALL_HEADER ClassInstallHeader;
    public uint Flags;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 20)] public IntPtr[] DynamicPages;
    public uint NumDynamicPages;
    public uint DynamicPageFlags;
    public uint PrivateFlags;
    public IntPtr PrivateData;
    public IntPtr hwndWizardDlg;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SP_CLASSINSTALL_HEADER
    Public cbSize As UInteger
    Public InstallFunction As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure SP_INSTALLWIZARD_DATA
    Public ClassInstallHeader As SP_CLASSINSTALL_HEADER
    Public Flags As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=20)> Public DynamicPages() As IntPtr
    Public NumDynamicPages As UInteger
    Public DynamicPageFlags As UInteger
    Public PrivateFlags As UInteger
    Public PrivateData As IntPtr
    Public hwndWizardDlg As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class SP_CLASSINSTALL_HEADER(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("InstallFunction", wintypes.DWORD),
    ]

class SP_INSTALLWIZARD_DATA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("ClassInstallHeader", SP_CLASSINSTALL_HEADER),
        ("Flags", wintypes.DWORD),
        ("DynamicPages", ctypes.c_void_p * 20),
        ("NumDynamicPages", wintypes.DWORD),
        ("DynamicPageFlags", wintypes.DWORD),
        ("PrivateFlags", wintypes.DWORD),
        ("PrivateData", ctypes.c_ssize_t),
        ("hwndWizardDlg", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct SP_CLASSINSTALL_HEADER {
    pub cbSize: u32,
    pub InstallFunction: u32,
}

#[repr(C, packed(1))]
pub struct SP_INSTALLWIZARD_DATA {
    pub ClassInstallHeader: SP_CLASSINSTALL_HEADER,
    pub Flags: u32,
    pub DynamicPages: [*mut core::ffi::c_void; 20],
    pub NumDynamicPages: u32,
    pub DynamicPageFlags: u32,
    pub PrivateFlags: u32,
    pub PrivateData: isize,
    pub hwndWizardDlg: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type SP_CLASSINSTALL_HEADER struct {
	cbSize uint32
	InstallFunction uint32
}

type SP_INSTALLWIZARD_DATA struct {
	ClassInstallHeader SP_CLASSINSTALL_HEADER
	Flags uint32
	DynamicPages [20]uintptr
	NumDynamicPages uint32
	DynamicPageFlags uint32
	PrivateFlags uint32
	PrivateData uintptr
	hwndWizardDlg uintptr
}
type
  SP_CLASSINSTALL_HEADER = record
    cbSize: DWORD;
    InstallFunction: DWORD;
  end;

  SP_INSTALLWIZARD_DATA = packed record
    ClassInstallHeader: SP_CLASSINSTALL_HEADER;
    Flags: DWORD;
    DynamicPages: array[0..19] of Pointer;
    NumDynamicPages: DWORD;
    DynamicPageFlags: DWORD;
    PrivateFlags: DWORD;
    PrivateData: NativeInt;
    hwndWizardDlg: Pointer;
  end;
const SP_CLASSINSTALL_HEADER = extern struct {
    cbSize: u32,
    InstallFunction: u32,
};

const SP_INSTALLWIZARD_DATA = extern struct {
    ClassInstallHeader: SP_CLASSINSTALL_HEADER,
    Flags: u32,
    DynamicPages: [20]?*anyopaque,
    NumDynamicPages: u32,
    DynamicPageFlags: u32,
    PrivateFlags: u32,
    PrivateData: isize,
    hwndWizardDlg: ?*anyopaque,
};
type
  SP_CLASSINSTALL_HEADER {.bycopy.} = object
    cbSize: uint32
    InstallFunction: uint32

  SP_INSTALLWIZARD_DATA {.packed.} = object
    ClassInstallHeader: SP_CLASSINSTALL_HEADER
    Flags: uint32
    DynamicPages: array[20, pointer]
    NumDynamicPages: uint32
    DynamicPageFlags: uint32
    PrivateFlags: uint32
    PrivateData: int
    hwndWizardDlg: pointer
struct SP_CLASSINSTALL_HEADER
{
    uint cbSize;
    uint InstallFunction;
}

align(1)
struct SP_INSTALLWIZARD_DATA
{
    SP_CLASSINSTALL_HEADER ClassInstallHeader;
    uint Flags;
    void*[20] DynamicPages;
    uint NumDynamicPages;
    uint DynamicPageFlags;
    uint PrivateFlags;
    ptrdiff_t PrivateData;
    void* hwndWizardDlg;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SP_INSTALLWIZARD_DATA サイズ: 112 バイト(x86)
dim st, 28    ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; ClassInstallHeader : SP_CLASSINSTALL_HEADER (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; Flags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DynamicPages : HPROPSHEETPAGE (+12, 80byte)  varptr(st)+12 を基点に操作(80byte:入れ子/配列)
; NumDynamicPages : DWORD (+92, 4byte)  st.23 = 値  /  値 = st.23   (lpoke/lpeek も可)
; DynamicPageFlags : DWORD (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; PrivateFlags : DWORD (+100, 4byte)  st.25 = 値  /  値 = st.25   (lpoke/lpeek も可)
; PrivateData : LPARAM (+104, 4byte)  st.26 = 値  /  値 = st.26   (lpoke/lpeek も可)
; hwndWizardDlg : HWND (+108, 4byte)  st.27 = 値  /  値 = st.27   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SP_INSTALLWIZARD_DATA サイズ: 200 バイト(x64)
dim st, 50    ; 4byte整数×50(構造体サイズ 200 / 4 切り上げ)
; ClassInstallHeader : SP_CLASSINSTALL_HEADER (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; Flags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DynamicPages : HPROPSHEETPAGE (+12, 160byte)  varptr(st)+12 を基点に操作(160byte:入れ子/配列)
; NumDynamicPages : DWORD (+172, 4byte)  st.43 = 値  /  値 = st.43   (lpoke/lpeek も可)
; DynamicPageFlags : DWORD (+176, 4byte)  st.44 = 値  /  値 = st.44   (lpoke/lpeek も可)
; PrivateFlags : DWORD (+180, 4byte)  st.45 = 値  /  値 = st.45   (lpoke/lpeek も可)
; PrivateData : LPARAM (+184, 8byte)  qpoke st,184,値 / qpeek(st,184)  ※IronHSPのみ。3.7/3.8は lpoke st,184,下位 : lpoke st,188,上位
; hwndWizardDlg : HWND (+192, 8byte)  qpoke st,192,値 / qpeek(st,192)  ※IronHSPのみ。3.7/3.8は lpoke st,192,下位 : lpoke st,196,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SP_CLASSINSTALL_HEADER
    #field int cbSize
    #field int InstallFunction
#endstruct

#defstruct global SP_INSTALLWIZARD_DATA, pack=1
    #field SP_CLASSINSTALL_HEADER ClassInstallHeader
    #field int Flags
    #field intptr DynamicPages 20
    #field int NumDynamicPages
    #field int DynamicPageFlags
    #field int PrivateFlags
    #field intptr PrivateData
    #field intptr hwndWizardDlg
#endstruct

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