ホーム › System.ApplicationInstallationAndServicing › PM_STARTTILEBLOB
PM_STARTTILEBLOB
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のバイトサイズ。 |
| ProductID | GUID | 16 | +4 | +4 | タイルが属するアプリ製品を識別するGUID。 |
| TileID | LPWSTR | 8/4 | +24 | +20 | タイルを識別する文字列。 |
| TemplateType | TILE_TEMPLATE_TYPE | 4 | +32 | +24 | タイルのテンプレート種別を示す列挙値。 |
| HubPosition | DWORD | 128 | +36 | +28 | スタート画面(ハブ)内でのタイル位置。 |
| HubVisibilityBitmask | DWORD | 4 | +164 | +156 | タイルの表示可否を示すビットマスク。 |
| IsDefault | BOOL | 4 | +168 | +160 | 既定タイルかを示す真偽値。 |
| TileType | PM_STARTTILE_TYPE | 4 | +172 | +164 | スタートタイルの種別を示す列挙値。 |
| pbPropBlob | BYTE* | 8/4 | +176 | +168 | タイル固有のプロパティを格納するバイナリBlobへのポインタ。 |
| cbPropBlob | DWORD | 4 | +184 | +172 | pbPropBlobのバイト長。 |
| IsRestoring | BOOL | 4 | +188 | +176 | 復元処理中のタイルかを示す真偽値。 |
| IsModern | BOOL | 4 | +192 | +180 | モダン(UWP)タイルかを示す真偽値。 |
| InvocationInfo | PM_INVOCATIONINFO | 16/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 Structureimport 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_INVOCATIONINFOstruct 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