ホーム › Devices.DeviceAndDriverInstallation › IO_RANGE

IO_RANGE

構造体

📘 Microsoft Learn (日本語) · English

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

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

フィールド

型

サイズ

x64

x86

説明

IOR_Align

ULONGLONG

最初に割り当てられる I/O ポートアドレスが配置されなければならないポートアドレス境界を指定するために使用するマスクです。

IOR_nPorts

DWORD

デバイスが必要とする I/O ポートアドレスの数です。

IOR_Min

ULONGLONG

+12

デバイスに割り当て可能な連続した I/O ポートアドレス範囲のうち、最も番号の小さいアドレスです。

IOR_Max

ULONGLONG

+20

デバイスに割り当て可能な連続した I/O ポートアドレス範囲のうち、最も番号の大きいアドレスです。

IOR_RangeFlags

IOD_DESFLAGS

+28

IO_DES 構造体のビットフラグを 1 つ指定します。詳細については、以降の Remarks セクションを参照してください。

IOR_Alias

ULONGLONG

+32

次の表に示すビットフラグのいずれか 1 つです。

フラグ	定義
IO_ALIAS_10_BIT_DECODE	デバイスはポートアドレスの 10 ビットをデコードします。
IO_ALIAS_12_BIT_DECODE	デバイスはポートアドレスの 12 ビットをデコードします。
IO_ALIAS_16_BIT_DECODE	デバイスはポートアドレスの 16 ビットをデコードします。
IO_ALIAS_POSITIVE_DECODE	デバイスは「サブトラクティブデコード」ではなく「ポジティブデコード」を使用します。

詳細については、以降の Remarks セクションを参照してください。

公式ドキュメント

IO_RANGE 構造体は、デバイスインスタンスの I/O ポートの使用状況を記述するリソース要件リストを指定します。リソース要件リストの詳細については、Hardware Resources を参照してください。

解説(Remarks)

IOR_Alias に指定するフラグは、IOD_DesFlags に指定するアドレスデコードフラグと同じ意味を持ちます (ただし、2 つのフラグの組は割り当てられている値が同じではないため、相互に入れ替えて使用することはできません)。リソース要件リストはどちらのフラグの組を使用しても指定できますが、IOD_DesFlags でデコードフラグを指定することを推奨します。アドレスデコードフラグを両方、すなわち IOD_DesFlags と IOR_Alias の両方で指定した場合は、後者の内容が前者を上書きします。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// IO_RANGE  (x64 40 / x86 40 バイト)
#pragma pack(push, 1)
typedef struct IO_RANGE {
    ULONGLONG IOR_Align;
    DWORD IOR_nPorts;
    ULONGLONG IOR_Min;
    ULONGLONG IOR_Max;
    IOD_DESFLAGS IOR_RangeFlags;
    ULONGLONG IOR_Alias;
} IO_RANGE;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct IO_RANGE
{
    public ulong IOR_Align;
    public uint IOR_nPorts;
    public ulong IOR_Min;
    public ulong IOR_Max;
    public uint IOR_RangeFlags;
    public ulong IOR_Alias;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure IO_RANGE
    Public IOR_Align As ULong
    Public IOR_nPorts As UInteger
    Public IOR_Min As ULong
    Public IOR_Max As ULong
    Public IOR_RangeFlags As UInteger
    Public IOR_Alias As ULong
End Structure

import ctypes
from ctypes import wintypes

class IO_RANGE(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("IOR_Align", ctypes.c_ulonglong),
        ("IOR_nPorts", wintypes.DWORD),
        ("IOR_Min", ctypes.c_ulonglong),
        ("IOR_Max", ctypes.c_ulonglong),
        ("IOR_RangeFlags", wintypes.DWORD),
        ("IOR_Alias", ctypes.c_ulonglong),
    ]

#[repr(C, packed(1))]
pub struct IO_RANGE {
    pub IOR_Align: u64,
    pub IOR_nPorts: u32,
    pub IOR_Min: u64,
    pub IOR_Max: u64,
    pub IOR_RangeFlags: u32,
    pub IOR_Alias: u64,
}

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

type IO_RANGE struct {
	IOR_Align uint64
	IOR_nPorts uint32
	IOR_Min uint64
	IOR_Max uint64
	IOR_RangeFlags uint32
	IOR_Alias uint64
}

type
  IO_RANGE = packed record
    IOR_Align: UInt64;
    IOR_nPorts: DWORD;
    IOR_Min: UInt64;
    IOR_Max: UInt64;
    IOR_RangeFlags: DWORD;
    IOR_Alias: UInt64;
  end;

const IO_RANGE = extern struct {
    IOR_Align: u64,
    IOR_nPorts: u32,
    IOR_Min: u64,
    IOR_Max: u64,
    IOR_RangeFlags: u32,
    IOR_Alias: u64,
};

type
  IO_RANGE {.packed.} = object
    IOR_Align: uint64
    IOR_nPorts: uint32
    IOR_Min: uint64
    IOR_Max: uint64
    IOR_RangeFlags: uint32
    IOR_Alias: uint64

align(1)
struct IO_RANGE
{
    ulong IOR_Align;
    uint IOR_nPorts;
    ulong IOR_Min;
    ulong IOR_Max;
    uint IOR_RangeFlags;
    ulong IOR_Alias;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; IO_RANGE サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; IOR_Align : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; IOR_nPorts : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; IOR_Min : ULONGLONG (+12, 8byte)  qpoke st,12,値 / qpeek(st,12)  ※IronHSPのみ。3.7/3.8は lpoke st,12,下位 : lpoke st,16,上位
; IOR_Max : ULONGLONG (+20, 8byte)  qpoke st,20,値 / qpeek(st,20)  ※IronHSPのみ。3.7/3.8は lpoke st,20,下位 : lpoke st,24,上位
; IOR_RangeFlags : IOD_DESFLAGS (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; IOR_Alias : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global IO_RANGE, pack=1
    #field int64 IOR_Align
    #field int IOR_nPorts
    #field int64 IOR_Min
    #field int64 IOR_Max
    #field int IOR_RangeFlags
    #field int64 IOR_Alias
#endstruct

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

IO_RANGE

フィールド

公式ドキュメント

解説(Remarks)

各言語での定義

HSP用 定義

HSP用定義