CLRES_FUNCTION_TABLE
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| TableSize | DWORD | 4 | +0 | +0 | 構造体のバイト単位のサイズです。 次のいずれかの値を指定できます。 CLRES_V1_FUNCTION_SIZEResource API バージョン 1.0 の関数テーブルのサイズです。 CLRES_V2_FUNCTION_SIZEResource API バージョン 2.0 の関数テーブルのサイズです。 Windows Server 2008 R2: この値は Windows Server 2012 より前ではサポートされません。 CLRES_V3_FUNCTION_SIZEResource API バージョン 3.0 の関数テーブルのサイズです。 Windows Server 2008 R2 および Windows Server 2012: この値は Windows Server 2012 R2 より前ではサポートされません。 |
| Version | DWORD | 4 | +4 | +4 | サポートされる Resource API のバージョンです。 次のいずれかの値を指定できます。 CLRES_VERSION_V1_00 (0x100)Resource API バージョン 1.0 です。 CLRES_VERSION_V2_00 (0x200)Resource API バージョン 2.0 です。 Windows Server 2008 R2: この値は Windows Server 2012 より前ではサポートされません。 CLRES_VERSION_V3_00 (0x300)Resource API バージョン 3.0 です。 Windows Server 2008 R2 および Windows Server 2012: この値は Windows Server 2012 R2 より前ではサポートされません。 |
| Anonymous | _Anonymous_e__Union | 112/56 | +8 | +8 | バージョンに応じたCLRES_Vn_FUNCTIONSを保持する無名共用体である。 |
共用体: _Anonymous_e__Union x64 112B / x86 56B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| V1Functions | CLRES_V1_FUNCTIONS | 88/44 | +0 | +0 | Resource API バージョン 1.0 に含まれるエントリ ポイントのテーブルを格納する CLRES_V1_FUNCTIONS 構造体です。 |
| V2Functions | CLRES_V2_FUNCTIONS | 96/48 | +0 | +0 | Resource API バージョン 2.0 に含まれるエントリ ポイントのテーブルを格納する CLRES_V2_FUNCTIONS 構造体です。 Windows Server 2008 R2: このメンバーは Windows Server 2012 で追加されました。 |
| V3Functions | CLRES_V3_FUNCTIONS | 96/48 | +0 | +0 | Resource API バージョン 3.0 に含まれるエントリ ポイントのテーブルを格納する CLRES_V3_FUNCTIONS 構造体です。 Windows Server 2008 R2 および Windows Server 2012: このメンバーは Windows Server 2012 R2 で追加されました。 |
| V4Functions | CLRES_V4_FUNCTIONS | 112/56 | +0 | +0 |
公式ドキュメント
任意のバージョンの Resource API の関数テーブルを記述します。
解説(Remarks)
<b>CLRES_FUNCTION_TABLE</b> 構造体内で同じオフセットにあることが保証されるのは、最初の 2 つのメンバーだけです。この構造体内のその他のエントリはすべて、サポートされる
<a href="/previous-versions/windows/desktop/mscs/resource-api">Resource API</a> のバージョンに依存します。
V1Functions メンバーは、Startup を除く すべての Resource API エントリ ポイントへのポインターを格納する CLRES_V1_FUNCTIONS 構造体です。次のエントリ ポイント関数へのポインターを除き、すべてのポインターは非 NULL でなければなりません。
詳細については、 Implementing Resource DLLs を参照してください。Resource API バージョン 1.0 の関数テーブルを作成するには、 CLRES_V1_FUNCTION_TABLE マクロを使用します。
Examples
Implementing Resource DLLs の Defining Structures and Constants を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CLRES_FUNCTION_TABLE (x64 120 / x86 64 バイト)
typedef struct CLRES_FUNCTION_TABLE {
DWORD TableSize;
DWORD Version;
_Anonymous_e__Union Anonymous;
} CLRES_FUNCTION_TABLE;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLRES_FUNCTION_TABLE
{
public uint TableSize;
public uint Version;
public _Anonymous_e__Union Anonymous;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLRES_FUNCTION_TABLE
Public TableSize As UInteger
Public Version As UInteger
Public Anonymous As _Anonymous_e__Union
End Structureimport ctypes
from ctypes import wintypes
class CLRES_FUNCTION_TABLE(ctypes.Structure):
_fields_ = [
("TableSize", wintypes.DWORD),
("Version", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
]#[repr(C)]
pub struct CLRES_FUNCTION_TABLE {
pub TableSize: u32,
pub Version: u32,
pub Anonymous: _Anonymous_e__Union,
}import "golang.org/x/sys/windows"
type CLRES_FUNCTION_TABLE struct {
TableSize uint32
Version uint32
Anonymous _Anonymous_e__Union
}type
CLRES_FUNCTION_TABLE = record
TableSize: DWORD;
Version: DWORD;
Anonymous: _Anonymous_e__Union;
end;const CLRES_FUNCTION_TABLE = extern struct {
TableSize: u32,
Version: u32,
Anonymous: _Anonymous_e__Union,
};type
CLRES_FUNCTION_TABLE {.bycopy.} = object
TableSize: uint32
Version: uint32
Anonymous: _Anonymous_e__Unionstruct CLRES_FUNCTION_TABLE
{
uint TableSize;
uint Version;
_Anonymous_e__Union Anonymous;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CLRES_FUNCTION_TABLE サイズ: 64 バイト(x86)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; TableSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Version : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 56byte) varptr(st)+8 を基点に操作(56byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLRES_FUNCTION_TABLE サイズ: 120 バイト(x64)
dim st, 30 ; 4byte整数×30(構造体サイズ 120 / 4 切り上げ)
; TableSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Version : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 112byte) varptr(st)+8 を基点に操作(112byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CLRES_FUNCTION_TABLE
#field int TableSize
#field int Version
#field byte Anonymous 112
#endstruct
stdim st, CLRES_FUNCTION_TABLE ; NSTRUCT 変数を確保
st->TableSize = 100
mes "TableSize=" + st->TableSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。