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

SCM_REGION

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

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

フィールド

フィールドサイズx64x86説明
VersionDWORD4+0+0この構造体のバージョン番号。
SizeDWORD4+4+4この構造体のバイト単位のサイズ。
FlagsDWORD4+8+8領域の属性を示すフラグのビットマスク。
NfitHandleDWORD4+12+12ACPI NFITテーブルにおけるデバイスハンドル。
LogicalDeviceGuidGUID16+16+16この領域が属する論理デバイスのGUID。
AddressRangeTypeGUID16+32+32アドレス範囲の種別を示すGUID。永続/揮発などを表す。
AssociatedIdDWORD4+48+48この領域に関連付けられた識別子。
LengthULONGLONG8+56+56領域の長さ。バイト単位。
StartingDPAULONGLONG8+64+64領域の開始デバイス物理アドレス(DPA)。
BaseSPAULONGLONG8+72+72領域のベースとなるシステム物理アドレス(SPA)。
SPAOffsetULONGLONG8+80+80BaseSPAからのオフセット。バイト単位。
RegionOffsetULONGLONG8+88+88論理デバイス内での領域のオフセット。バイト単位。

各言語での定義

#include <windows.h>

// SCM_REGION  (x64 96 / x86 96 バイト)
typedef struct SCM_REGION {
    DWORD Version;
    DWORD Size;
    DWORD Flags;
    DWORD NfitHandle;
    GUID LogicalDeviceGuid;
    GUID AddressRangeType;
    DWORD AssociatedId;
    ULONGLONG Length;
    ULONGLONG StartingDPA;
    ULONGLONG BaseSPA;
    ULONGLONG SPAOffset;
    ULONGLONG RegionOffset;
} SCM_REGION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SCM_REGION
{
    public uint Version;
    public uint Size;
    public uint Flags;
    public uint NfitHandle;
    public Guid LogicalDeviceGuid;
    public Guid AddressRangeType;
    public uint AssociatedId;
    public ulong Length;
    public ulong StartingDPA;
    public ulong BaseSPA;
    public ulong SPAOffset;
    public ulong RegionOffset;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SCM_REGION
    Public Version As UInteger
    Public Size As UInteger
    Public Flags As UInteger
    Public NfitHandle As UInteger
    Public LogicalDeviceGuid As Guid
    Public AddressRangeType As Guid
    Public AssociatedId As UInteger
    Public Length As ULong
    Public StartingDPA As ULong
    Public BaseSPA As ULong
    Public SPAOffset As ULong
    Public RegionOffset As ULong
End Structure
import ctypes
from ctypes import wintypes

class SCM_REGION(ctypes.Structure):
    _fields_ = [
        ("Version", wintypes.DWORD),
        ("Size", wintypes.DWORD),
        ("Flags", wintypes.DWORD),
        ("NfitHandle", wintypes.DWORD),
        ("LogicalDeviceGuid", GUID),
        ("AddressRangeType", GUID),
        ("AssociatedId", wintypes.DWORD),
        ("Length", ctypes.c_ulonglong),
        ("StartingDPA", ctypes.c_ulonglong),
        ("BaseSPA", ctypes.c_ulonglong),
        ("SPAOffset", ctypes.c_ulonglong),
        ("RegionOffset", ctypes.c_ulonglong),
    ]
#[repr(C)]
pub struct SCM_REGION {
    pub Version: u32,
    pub Size: u32,
    pub Flags: u32,
    pub NfitHandle: u32,
    pub LogicalDeviceGuid: GUID,
    pub AddressRangeType: GUID,
    pub AssociatedId: u32,
    pub Length: u64,
    pub StartingDPA: u64,
    pub BaseSPA: u64,
    pub SPAOffset: u64,
    pub RegionOffset: u64,
}
import "golang.org/x/sys/windows"

type SCM_REGION struct {
	Version uint32
	Size uint32
	Flags uint32
	NfitHandle uint32
	LogicalDeviceGuid windows.GUID
	AddressRangeType windows.GUID
	AssociatedId uint32
	Length uint64
	StartingDPA uint64
	BaseSPA uint64
	SPAOffset uint64
	RegionOffset uint64
}
type
  SCM_REGION = record
    Version: DWORD;
    Size: DWORD;
    Flags: DWORD;
    NfitHandle: DWORD;
    LogicalDeviceGuid: TGUID;
    AddressRangeType: TGUID;
    AssociatedId: DWORD;
    Length: UInt64;
    StartingDPA: UInt64;
    BaseSPA: UInt64;
    SPAOffset: UInt64;
    RegionOffset: UInt64;
  end;
const SCM_REGION = extern struct {
    Version: u32,
    Size: u32,
    Flags: u32,
    NfitHandle: u32,
    LogicalDeviceGuid: GUID,
    AddressRangeType: GUID,
    AssociatedId: u32,
    Length: u64,
    StartingDPA: u64,
    BaseSPA: u64,
    SPAOffset: u64,
    RegionOffset: u64,
};
type
  SCM_REGION {.bycopy.} = object
    Version: uint32
    Size: uint32
    Flags: uint32
    NfitHandle: uint32
    LogicalDeviceGuid: GUID
    AddressRangeType: GUID
    AssociatedId: uint32
    Length: uint64
    StartingDPA: uint64
    BaseSPA: uint64
    SPAOffset: uint64
    RegionOffset: uint64
struct SCM_REGION
{
    uint Version;
    uint Size;
    uint Flags;
    uint NfitHandle;
    GUID LogicalDeviceGuid;
    GUID AddressRangeType;
    uint AssociatedId;
    ulong Length;
    ulong StartingDPA;
    ulong BaseSPA;
    ulong SPAOffset;
    ulong RegionOffset;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SCM_REGION サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Size : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Flags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; NfitHandle : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; LogicalDeviceGuid : GUID (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; AddressRangeType : GUID (+32, 16byte)  varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; AssociatedId : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; Length : ULONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; StartingDPA : ULONGLONG (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; BaseSPA : ULONGLONG (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; SPAOffset : ULONGLONG (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; RegionOffset : ULONGLONG (+88, 8byte)  qpoke st,88,値 / qpeek(st,88)  ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; ※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 SCM_REGION
    #field int Version
    #field int Size
    #field int Flags
    #field int NfitHandle
    #field GUID LogicalDeviceGuid
    #field GUID AddressRangeType
    #field int AssociatedId
    #field int64 Length
    #field int64 StartingDPA
    #field int64 BaseSPA
    #field int64 SPAOffset
    #field int64 RegionOffset
#endstruct

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