Win32 API 日本語リファレンス
ホームSystem.ApplicationInstallationAndServicing › PM_STARTTILEBLOB

PM_STARTTILEBLOB

構造体
サイズx64: 216 バイト / x86: 192 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のバイトサイズ。
ProductIDGUID16+4+4タイルが属するアプリ製品を識別するGUID。
TileIDLPWSTR8/4+24+20タイルを識別する文字列。
TemplateTypeTILE_TEMPLATE_TYPE4+32+24タイルのテンプレート種別を示す列挙値。
HubPositionDWORD128+36+28スタート画面(ハブ)内でのタイル位置。
HubVisibilityBitmaskDWORD4+164+156タイルの表示可否を示すビットマスク。
IsDefaultBOOL4+168+160既定タイルかを示す真偽値。
TileTypePM_STARTTILE_TYPE4+172+164スタートタイルの種別を示す列挙値。
pbPropBlobBYTE*8/4+176+168タイル固有のプロパティを格納するバイナリBlobへのポインタ。
cbPropBlobDWORD4+184+172pbPropBlobのバイト長。
IsRestoringBOOL4+188+176復元処理中のタイルかを示す真偽値。
IsModernBOOL4+192+180モダン(UWP)タイルかを示す真偽値。
InvocationInfoPM_INVOCATIONINFO16/8+200+184タイル起動時に用いる起動情報(PM_INVOCATIONINFO)。

各言語での定義

#include <windows.h>

// PM_INVOCATIONINFO  (x64 16 / x86 8 バイト)
typedef struct PM_INVOCATIONINFO {
    LPWSTR URIBaseOrAUMID;
    LPWSTR URIFragmentOrArgs;
} PM_INVOCATIONINFO;

// PM_STARTTILEBLOB  (x64 216 / x86 192 バイト)
typedef struct PM_STARTTILEBLOB {
    DWORD cbSize;
    GUID ProductID;
    LPWSTR TileID;
    TILE_TEMPLATE_TYPE TemplateType;
    DWORD HubPosition[32];
    DWORD HubVisibilityBitmask;
    BOOL IsDefault;
    PM_STARTTILE_TYPE TileType;
    BYTE* pbPropBlob;
    DWORD cbPropBlob;
    BOOL IsRestoring;
    BOOL IsModern;
    PM_INVOCATIONINFO InvocationInfo;
} PM_STARTTILEBLOB;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PM_INVOCATIONINFO
{
    public IntPtr URIBaseOrAUMID;
    public IntPtr URIFragmentOrArgs;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PM_STARTTILEBLOB
{
    public uint cbSize;
    public Guid ProductID;
    public IntPtr TileID;
    public int TemplateType;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 32)] public uint[] HubPosition;
    public uint HubVisibilityBitmask;
    [MarshalAs(UnmanagedType.Bool)] public bool IsDefault;
    public int TileType;
    public IntPtr pbPropBlob;
    public uint cbPropBlob;
    [MarshalAs(UnmanagedType.Bool)] public bool IsRestoring;
    [MarshalAs(UnmanagedType.Bool)] public bool IsModern;
    public PM_INVOCATIONINFO InvocationInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PM_INVOCATIONINFO
    Public URIBaseOrAUMID As IntPtr
    Public URIFragmentOrArgs As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PM_STARTTILEBLOB
    Public cbSize As UInteger
    Public ProductID As Guid
    Public TileID As IntPtr
    Public TemplateType As Integer
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=32)> Public HubPosition() As UInteger
    Public HubVisibilityBitmask As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public IsDefault As Boolean
    Public TileType As Integer
    Public pbPropBlob As IntPtr
    Public cbPropBlob As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public IsRestoring As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public IsModern As Boolean
    Public InvocationInfo As PM_INVOCATIONINFO
End Structure
import ctypes
from ctypes import wintypes

class PM_INVOCATIONINFO(ctypes.Structure):
    _fields_ = [
        ("URIBaseOrAUMID", ctypes.c_void_p),
        ("URIFragmentOrArgs", ctypes.c_void_p),
    ]

class PM_STARTTILEBLOB(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("ProductID", GUID),
        ("TileID", ctypes.c_void_p),
        ("TemplateType", ctypes.c_int),
        ("HubPosition", wintypes.DWORD * 32),
        ("HubVisibilityBitmask", wintypes.DWORD),
        ("IsDefault", wintypes.BOOL),
        ("TileType", ctypes.c_int),
        ("pbPropBlob", ctypes.c_void_p),
        ("cbPropBlob", wintypes.DWORD),
        ("IsRestoring", wintypes.BOOL),
        ("IsModern", wintypes.BOOL),
        ("InvocationInfo", PM_INVOCATIONINFO),
    ]
#[repr(C)]
pub struct PM_INVOCATIONINFO {
    pub URIBaseOrAUMID: *mut core::ffi::c_void,
    pub URIFragmentOrArgs: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct PM_STARTTILEBLOB {
    pub cbSize: u32,
    pub ProductID: GUID,
    pub TileID: *mut core::ffi::c_void,
    pub TemplateType: i32,
    pub HubPosition: [u32; 32],
    pub HubVisibilityBitmask: u32,
    pub IsDefault: i32,
    pub TileType: i32,
    pub pbPropBlob: *mut core::ffi::c_void,
    pub cbPropBlob: u32,
    pub IsRestoring: i32,
    pub IsModern: i32,
    pub InvocationInfo: PM_INVOCATIONINFO,
}
import "golang.org/x/sys/windows"

type PM_INVOCATIONINFO struct {
	URIBaseOrAUMID uintptr
	URIFragmentOrArgs uintptr
}

type PM_STARTTILEBLOB struct {
	cbSize uint32
	ProductID windows.GUID
	TileID uintptr
	TemplateType int32
	HubPosition [32]uint32
	HubVisibilityBitmask uint32
	IsDefault int32
	TileType int32
	pbPropBlob uintptr
	cbPropBlob uint32
	IsRestoring int32
	IsModern int32
	InvocationInfo PM_INVOCATIONINFO
}
type
  PM_INVOCATIONINFO = record
    URIBaseOrAUMID: Pointer;
    URIFragmentOrArgs: Pointer;
  end;

  PM_STARTTILEBLOB = record
    cbSize: DWORD;
    ProductID: TGUID;
    TileID: Pointer;
    TemplateType: Integer;
    HubPosition: array[0..31] of DWORD;
    HubVisibilityBitmask: DWORD;
    IsDefault: BOOL;
    TileType: Integer;
    pbPropBlob: Pointer;
    cbPropBlob: DWORD;
    IsRestoring: BOOL;
    IsModern: BOOL;
    InvocationInfo: PM_INVOCATIONINFO;
  end;
const PM_INVOCATIONINFO = extern struct {
    URIBaseOrAUMID: ?*anyopaque,
    URIFragmentOrArgs: ?*anyopaque,
};

const PM_STARTTILEBLOB = extern struct {
    cbSize: u32,
    ProductID: GUID,
    TileID: ?*anyopaque,
    TemplateType: i32,
    HubPosition: [32]u32,
    HubVisibilityBitmask: u32,
    IsDefault: i32,
    TileType: i32,
    pbPropBlob: ?*anyopaque,
    cbPropBlob: u32,
    IsRestoring: i32,
    IsModern: i32,
    InvocationInfo: PM_INVOCATIONINFO,
};
type
  PM_INVOCATIONINFO {.bycopy.} = object
    URIBaseOrAUMID: pointer
    URIFragmentOrArgs: pointer

  PM_STARTTILEBLOB {.bycopy.} = object
    cbSize: uint32
    ProductID: GUID
    TileID: pointer
    TemplateType: int32
    HubPosition: array[32, uint32]
    HubVisibilityBitmask: uint32
    IsDefault: int32
    TileType: int32
    pbPropBlob: pointer
    cbPropBlob: uint32
    IsRestoring: int32
    IsModern: int32
    InvocationInfo: PM_INVOCATIONINFO
struct PM_INVOCATIONINFO
{
    void* URIBaseOrAUMID;
    void* URIFragmentOrArgs;
}

struct PM_STARTTILEBLOB
{
    uint cbSize;
    GUID ProductID;
    void* TileID;
    int TemplateType;
    uint[32] HubPosition;
    uint HubVisibilityBitmask;
    int IsDefault;
    int TileType;
    void* pbPropBlob;
    uint cbPropBlob;
    int IsRestoring;
    int IsModern;
    PM_INVOCATIONINFO InvocationInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PM_STARTTILEBLOB サイズ: 192 バイト(x86)
dim st, 48    ; 4byte整数×48(構造体サイズ 192 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ProductID : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; TileID : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; TemplateType : TILE_TEMPLATE_TYPE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; HubPosition : DWORD (+28, 128byte)  varptr(st)+28 を基点に操作(128byte:入れ子/配列)
; HubVisibilityBitmask : DWORD (+156, 4byte)  st.39 = 値  /  値 = st.39   (lpoke/lpeek も可)
; IsDefault : BOOL (+160, 4byte)  st.40 = 値  /  値 = st.40   (lpoke/lpeek も可)
; TileType : PM_STARTTILE_TYPE (+164, 4byte)  st.41 = 値  /  値 = st.41   (lpoke/lpeek も可)
; pbPropBlob : BYTE* (+168, 4byte)  st.42 = 値  /  値 = st.42   (lpoke/lpeek も可)
; cbPropBlob : DWORD (+172, 4byte)  st.43 = 値  /  値 = st.43   (lpoke/lpeek も可)
; IsRestoring : BOOL (+176, 4byte)  st.44 = 値  /  値 = st.44   (lpoke/lpeek も可)
; IsModern : BOOL (+180, 4byte)  st.45 = 値  /  値 = st.45   (lpoke/lpeek も可)
; InvocationInfo : PM_INVOCATIONINFO (+184, 8byte)  varptr(st)+184 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PM_STARTTILEBLOB サイズ: 216 バイト(x64)
dim st, 54    ; 4byte整数×54(構造体サイズ 216 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ProductID : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; TileID : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; TemplateType : TILE_TEMPLATE_TYPE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; HubPosition : DWORD (+36, 128byte)  varptr(st)+36 を基点に操作(128byte:入れ子/配列)
; HubVisibilityBitmask : DWORD (+164, 4byte)  st.41 = 値  /  値 = st.41   (lpoke/lpeek も可)
; IsDefault : BOOL (+168, 4byte)  st.42 = 値  /  値 = st.42   (lpoke/lpeek も可)
; TileType : PM_STARTTILE_TYPE (+172, 4byte)  st.43 = 値  /  値 = st.43   (lpoke/lpeek も可)
; pbPropBlob : BYTE* (+176, 8byte)  qpoke st,176,値 / qpeek(st,176)  ※IronHSPのみ。3.7/3.8は lpoke st,176,下位 : lpoke st,180,上位
; cbPropBlob : DWORD (+184, 4byte)  st.46 = 値  /  値 = st.46   (lpoke/lpeek も可)
; IsRestoring : BOOL (+188, 4byte)  st.47 = 値  /  値 = st.47   (lpoke/lpeek も可)
; IsModern : BOOL (+192, 4byte)  st.48 = 値  /  値 = st.48   (lpoke/lpeek も可)
; InvocationInfo : PM_INVOCATIONINFO (+200, 16byte)  varptr(st)+200 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global PM_INVOCATIONINFO
    #field intptr URIBaseOrAUMID
    #field intptr URIFragmentOrArgs
#endstruct

#defstruct global PM_STARTTILEBLOB
    #field int cbSize
    #field GUID ProductID
    #field intptr TileID
    #field int TemplateType
    #field int HubPosition 32
    #field int HubVisibilityBitmask
    #field bool IsDefault
    #field int TileType
    #field intptr pbPropBlob
    #field int cbPropBlob
    #field bool IsRestoring
    #field bool IsModern
    #field PM_INVOCATIONINFO InvocationInfo
#endstruct

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