ホーム › UI.Shell › FILEGROUPDESCRIPTORW

FILEGROUPDESCRIPTORW

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
cItems	DWORD	4	+0	+0	fgd配列に含まれるファイル記述子の数。
fgd	FILEDESCRIPTORW	592	+4	+4	FILEDESCRIPTORW構造体の可変長配列。各ファイルの記述を保持する。

各言語での定義

#include <windows.h>

// SIZE  (x64 8 / x86 8 バイト)
typedef struct SIZE {
    INT cx;
    INT cy;
} SIZE;

// POINTL  (x64 8 / x86 8 バイト)
typedef struct POINTL {
    INT x;
    INT y;
} POINTL;

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// FILEDESCRIPTORW  (x64 592 / x86 592 バイト)
#pragma pack(push, 1)
typedef struct FILEDESCRIPTORW {
    DWORD dwFlags;
    GUID clsid;
    SIZE sizel;
    POINTL pointl;
    DWORD dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    DWORD nFileSizeHigh;
    DWORD nFileSizeLow;
    WCHAR cFileName[260];
} FILEDESCRIPTORW;
#pragma pack(pop)

// FILEGROUPDESCRIPTORW  (x64 596 / x86 596 バイト)
#pragma pack(push, 1)
typedef struct FILEGROUPDESCRIPTORW {
    DWORD cItems;
    FILEDESCRIPTORW fgd[1];
} FILEGROUPDESCRIPTORW;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SIZE
{
    public int cx;
    public int cy;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINTL
{
    public int x;
    public int y;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct FILEDESCRIPTORW
{
    public uint dwFlags;
    public Guid clsid;
    public SIZE sizel;
    public POINTL pointl;
    public uint dwFileAttributes;
    public FILETIME ftCreationTime;
    public FILETIME ftLastAccessTime;
    public FILETIME ftLastWriteTime;
    public uint nFileSizeHigh;
    public uint nFileSizeLow;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string cFileName;
}

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct FILEGROUPDESCRIPTORW
{
    public uint cItems;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public FILEDESCRIPTORW[] fgd;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SIZE
    Public cx As Integer
    Public cy As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINTL
    Public x As Integer
    Public y As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure FILEDESCRIPTORW
    Public dwFlags As UInteger
    Public clsid As Guid
    Public sizel As SIZE
    Public pointl As POINTL
    Public dwFileAttributes As UInteger
    Public ftCreationTime As FILETIME
    Public ftLastAccessTime As FILETIME
    Public ftLastWriteTime As FILETIME
    Public nFileSizeHigh As UInteger
    Public nFileSizeLow As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public cFileName As String
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure FILEGROUPDESCRIPTORW
    Public cItems As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public fgd() As FILEDESCRIPTORW
End Structure

import ctypes
from ctypes import wintypes

class SIZE(ctypes.Structure):
    _fields_ = [
        ("cx", ctypes.c_int),
        ("cy", ctypes.c_int),
    ]

class POINTL(ctypes.Structure):
    _fields_ = [
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
    ]

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class FILEDESCRIPTORW(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("dwFlags", wintypes.DWORD),
        ("clsid", GUID),
        ("sizel", SIZE),
        ("pointl", POINTL),
        ("dwFileAttributes", wintypes.DWORD),
        ("ftCreationTime", FILETIME),
        ("ftLastAccessTime", FILETIME),
        ("ftLastWriteTime", FILETIME),
        ("nFileSizeHigh", wintypes.DWORD),
        ("nFileSizeLow", wintypes.DWORD),
        ("cFileName", ctypes.c_wchar * 260),
    ]

class FILEGROUPDESCRIPTORW(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("cItems", wintypes.DWORD),
        ("fgd", FILEDESCRIPTORW * 1),
    ]

#[repr(C)]
pub struct SIZE {
    pub cx: i32,
    pub cy: i32,
}

#[repr(C)]
pub struct POINTL {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C, packed(1))]
pub struct FILEDESCRIPTORW {
    pub dwFlags: u32,
    pub clsid: GUID,
    pub sizel: SIZE,
    pub pointl: POINTL,
    pub dwFileAttributes: u32,
    pub ftCreationTime: FILETIME,
    pub ftLastAccessTime: FILETIME,
    pub ftLastWriteTime: FILETIME,
    pub nFileSizeHigh: u32,
    pub nFileSizeLow: u32,
    pub cFileName: [u16; 260],
}

#[repr(C, packed(1))]
pub struct FILEGROUPDESCRIPTORW {
    pub cItems: u32,
    pub fgd: [FILEDESCRIPTORW; 1],
}

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

type SIZE struct {
	cx int32
	cy int32
}

type POINTL struct {
	x int32
	y int32
}

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type FILEDESCRIPTORW struct {
	dwFlags uint32
	clsid windows.GUID
	sizel SIZE
	pointl POINTL
	dwFileAttributes uint32
	ftCreationTime FILETIME
	ftLastAccessTime FILETIME
	ftLastWriteTime FILETIME
	nFileSizeHigh uint32
	nFileSizeLow uint32
	cFileName [260]uint16
}

type FILEGROUPDESCRIPTORW struct {
	cItems uint32
	fgd [1]FILEDESCRIPTORW
}

type
  SIZE = record
    cx: Integer;
    cy: Integer;
  end;

  POINTL = record
    x: Integer;
    y: Integer;
  end;

  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  FILEDESCRIPTORW = packed record
    dwFlags: DWORD;
    clsid: TGUID;
    sizel: SIZE;
    pointl: POINTL;
    dwFileAttributes: DWORD;
    ftCreationTime: FILETIME;
    ftLastAccessTime: FILETIME;
    ftLastWriteTime: FILETIME;
    nFileSizeHigh: DWORD;
    nFileSizeLow: DWORD;
    cFileName: array[0..259] of WideChar;
  end;

  FILEGROUPDESCRIPTORW = packed record
    cItems: DWORD;
    fgd: array[0..0] of FILEDESCRIPTORW;
  end;

const SIZE = extern struct {
    cx: i32,
    cy: i32,
};

const POINTL = extern struct {
    x: i32,
    y: i32,
};

const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const FILEDESCRIPTORW = extern struct {
    dwFlags: u32,
    clsid: GUID,
    sizel: SIZE,
    pointl: POINTL,
    dwFileAttributes: u32,
    ftCreationTime: FILETIME,
    ftLastAccessTime: FILETIME,
    ftLastWriteTime: FILETIME,
    nFileSizeHigh: u32,
    nFileSizeLow: u32,
    cFileName: [260]u16,
};

const FILEGROUPDESCRIPTORW = extern struct {
    cItems: u32,
    fgd: [1]FILEDESCRIPTORW,
};

type
  SIZE {.bycopy.} = object
    cx: int32
    cy: int32

  POINTL {.bycopy.} = object
    x: int32
    y: int32

  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  FILEDESCRIPTORW {.packed.} = object
    dwFlags: uint32
    clsid: GUID
    sizel: SIZE
    pointl: POINTL
    dwFileAttributes: uint32
    ftCreationTime: FILETIME
    ftLastAccessTime: FILETIME
    ftLastWriteTime: FILETIME
    nFileSizeHigh: uint32
    nFileSizeLow: uint32
    cFileName: array[260, uint16]

  FILEGROUPDESCRIPTORW {.packed.} = object
    cItems: uint32
    fgd: array[1, FILEDESCRIPTORW]

struct SIZE
{
    int cx;
    int cy;
}

struct POINTL
{
    int x;
    int y;
}

struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

align(1)
struct FILEDESCRIPTORW
{
    uint dwFlags;
    GUID clsid;
    SIZE sizel;
    POINTL pointl;
    uint dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    uint nFileSizeHigh;
    uint nFileSizeLow;
    wchar[260] cFileName;
}

align(1)
struct FILEGROUPDESCRIPTORW
{
    uint cItems;
    FILEDESCRIPTORW[1] fgd;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FILEGROUPDESCRIPTORW サイズ: 596 バイト(x64)
dim st, 149    ; 4byte整数×149(構造体サイズ 596 / 4 切り上げ)
; cItems : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fgd : FILEDESCRIPTORW (+4, 592byte)  varptr(st)+4 を基点に操作(592byte:入れ子/配列)
; ※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 SIZE
    #field int cx
    #field int cy
#endstruct

#defstruct global POINTL
    #field int x
    #field int y
#endstruct

#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global FILEDESCRIPTORW, pack=1
    #field int dwFlags
    #field GUID clsid
    #field SIZE sizel
    #field POINTL pointl
    #field int dwFileAttributes
    #field FILETIME ftCreationTime
    #field FILETIME ftLastAccessTime
    #field FILETIME ftLastWriteTime
    #field int nFileSizeHigh
    #field int nFileSizeLow
    #field wchar cFileName 260
#endstruct

#defstruct global FILEGROUPDESCRIPTORW, pack=1
    #field int cItems
    #field FILEDESCRIPTORW fgd 1
#endstruct

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

FILEGROUPDESCRIPTORW

フィールド

各言語での定義

HSP用 定義

HSP用定義