Win32 API 日本語リファレンス
ホームNetworkManagement.Ndis › NDIS_PORT_ARRAY

NDIS_PORT_ARRAY

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

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

フィールド

フィールドサイズx64x86説明
HeaderNDIS_OBJECT_HEADER4+0+0構造体の型・リビジョン・サイズを示すNDISオブジェクトヘッダー。
NumberOfPortsDWORD4+4+4配列に含まれるポートの数。
OffsetFirstPortDWORD4+8+8本構造体先頭から最初のポートまでのオフセット(バイト)。
ElementSizeDWORD4+12+12各ポート要素のサイズ(バイト)。
PortsNDIS_PORT_CHARACTERISTICS64+16+16ポート特性情報を格納する可変長配列の先頭要素。

各言語での定義

#include <windows.h>

// NDIS_OBJECT_HEADER  (x64 4 / x86 4 バイト)
typedef struct NDIS_OBJECT_HEADER {
    BYTE Type;
    BYTE Revision;
    WORD Size;
} NDIS_OBJECT_HEADER;

// NDIS_PORT_CHARACTERISTICS  (x64 64 / x86 64 バイト)
typedef struct NDIS_PORT_CHARACTERISTICS {
    NDIS_OBJECT_HEADER Header;
    DWORD PortNumber;
    DWORD Flags;
    NDIS_PORT_TYPE Type;
    NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
    ULONGLONG XmitLinkSpeed;
    ULONGLONG RcvLinkSpeed;
    NET_IF_DIRECTION_TYPE Direction;
    NDIS_PORT_CONTROL_STATE SendControlState;
    NDIS_PORT_CONTROL_STATE RcvControlState;
    NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
    NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
} NDIS_PORT_CHARACTERISTICS;

// NDIS_PORT_ARRAY  (x64 80 / x86 80 バイト)
typedef struct NDIS_PORT_ARRAY {
    NDIS_OBJECT_HEADER Header;
    DWORD NumberOfPorts;
    DWORD OffsetFirstPort;
    DWORD ElementSize;
    NDIS_PORT_CHARACTERISTICS Ports[1];
} NDIS_PORT_ARRAY;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NDIS_OBJECT_HEADER
{
    public byte Type;
    public byte Revision;
    public ushort Size;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NDIS_PORT_CHARACTERISTICS
{
    public NDIS_OBJECT_HEADER Header;
    public uint PortNumber;
    public uint Flags;
    public int Type;
    public int MediaConnectState;
    public ulong XmitLinkSpeed;
    public ulong RcvLinkSpeed;
    public int Direction;
    public int SendControlState;
    public int RcvControlState;
    public int SendAuthorizationState;
    public int RcvAuthorizationState;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NDIS_PORT_ARRAY
{
    public NDIS_OBJECT_HEADER Header;
    public uint NumberOfPorts;
    public uint OffsetFirstPort;
    public uint ElementSize;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public NDIS_PORT_CHARACTERISTICS[] Ports;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NDIS_OBJECT_HEADER
    Public Type As Byte
    Public Revision As Byte
    Public Size As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NDIS_PORT_CHARACTERISTICS
    Public Header As NDIS_OBJECT_HEADER
    Public PortNumber As UInteger
    Public Flags As UInteger
    Public Type As Integer
    Public MediaConnectState As Integer
    Public XmitLinkSpeed As ULong
    Public RcvLinkSpeed As ULong
    Public Direction As Integer
    Public SendControlState As Integer
    Public RcvControlState As Integer
    Public SendAuthorizationState As Integer
    Public RcvAuthorizationState As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NDIS_PORT_ARRAY
    Public Header As NDIS_OBJECT_HEADER
    Public NumberOfPorts As UInteger
    Public OffsetFirstPort As UInteger
    Public ElementSize As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public Ports() As NDIS_PORT_CHARACTERISTICS
End Structure
import ctypes
from ctypes import wintypes

class NDIS_OBJECT_HEADER(ctypes.Structure):
    _fields_ = [
        ("Type", ctypes.c_ubyte),
        ("Revision", ctypes.c_ubyte),
        ("Size", ctypes.c_ushort),
    ]

class NDIS_PORT_CHARACTERISTICS(ctypes.Structure):
    _fields_ = [
        ("Header", NDIS_OBJECT_HEADER),
        ("PortNumber", wintypes.DWORD),
        ("Flags", wintypes.DWORD),
        ("Type", ctypes.c_int),
        ("MediaConnectState", ctypes.c_int),
        ("XmitLinkSpeed", ctypes.c_ulonglong),
        ("RcvLinkSpeed", ctypes.c_ulonglong),
        ("Direction", ctypes.c_int),
        ("SendControlState", ctypes.c_int),
        ("RcvControlState", ctypes.c_int),
        ("SendAuthorizationState", ctypes.c_int),
        ("RcvAuthorizationState", ctypes.c_int),
    ]

class NDIS_PORT_ARRAY(ctypes.Structure):
    _fields_ = [
        ("Header", NDIS_OBJECT_HEADER),
        ("NumberOfPorts", wintypes.DWORD),
        ("OffsetFirstPort", wintypes.DWORD),
        ("ElementSize", wintypes.DWORD),
        ("Ports", NDIS_PORT_CHARACTERISTICS * 1),
    ]
#[repr(C)]
pub struct NDIS_OBJECT_HEADER {
    pub Type: u8,
    pub Revision: u8,
    pub Size: u16,
}

#[repr(C)]
pub struct NDIS_PORT_CHARACTERISTICS {
    pub Header: NDIS_OBJECT_HEADER,
    pub PortNumber: u32,
    pub Flags: u32,
    pub Type: i32,
    pub MediaConnectState: i32,
    pub XmitLinkSpeed: u64,
    pub RcvLinkSpeed: u64,
    pub Direction: i32,
    pub SendControlState: i32,
    pub RcvControlState: i32,
    pub SendAuthorizationState: i32,
    pub RcvAuthorizationState: i32,
}

#[repr(C)]
pub struct NDIS_PORT_ARRAY {
    pub Header: NDIS_OBJECT_HEADER,
    pub NumberOfPorts: u32,
    pub OffsetFirstPort: u32,
    pub ElementSize: u32,
    pub Ports: [NDIS_PORT_CHARACTERISTICS; 1],
}
import "golang.org/x/sys/windows"

type NDIS_OBJECT_HEADER struct {
	Type byte
	Revision byte
	Size uint16
}

type NDIS_PORT_CHARACTERISTICS struct {
	Header NDIS_OBJECT_HEADER
	PortNumber uint32
	Flags uint32
	Type int32
	MediaConnectState int32
	XmitLinkSpeed uint64
	RcvLinkSpeed uint64
	Direction int32
	SendControlState int32
	RcvControlState int32
	SendAuthorizationState int32
	RcvAuthorizationState int32
}

type NDIS_PORT_ARRAY struct {
	Header NDIS_OBJECT_HEADER
	NumberOfPorts uint32
	OffsetFirstPort uint32
	ElementSize uint32
	Ports [1]NDIS_PORT_CHARACTERISTICS
}
type
  NDIS_OBJECT_HEADER = record
    Type: Byte;
    Revision: Byte;
    Size: Word;
  end;

  NDIS_PORT_CHARACTERISTICS = record
    Header: NDIS_OBJECT_HEADER;
    PortNumber: DWORD;
    Flags: DWORD;
    Type: Integer;
    MediaConnectState: Integer;
    XmitLinkSpeed: UInt64;
    RcvLinkSpeed: UInt64;
    Direction: Integer;
    SendControlState: Integer;
    RcvControlState: Integer;
    SendAuthorizationState: Integer;
    RcvAuthorizationState: Integer;
  end;

  NDIS_PORT_ARRAY = record
    Header: NDIS_OBJECT_HEADER;
    NumberOfPorts: DWORD;
    OffsetFirstPort: DWORD;
    ElementSize: DWORD;
    Ports: array[0..0] of NDIS_PORT_CHARACTERISTICS;
  end;
const NDIS_OBJECT_HEADER = extern struct {
    Type: u8,
    Revision: u8,
    Size: u16,
};

const NDIS_PORT_CHARACTERISTICS = extern struct {
    Header: NDIS_OBJECT_HEADER,
    PortNumber: u32,
    Flags: u32,
    Type: i32,
    MediaConnectState: i32,
    XmitLinkSpeed: u64,
    RcvLinkSpeed: u64,
    Direction: i32,
    SendControlState: i32,
    RcvControlState: i32,
    SendAuthorizationState: i32,
    RcvAuthorizationState: i32,
};

const NDIS_PORT_ARRAY = extern struct {
    Header: NDIS_OBJECT_HEADER,
    NumberOfPorts: u32,
    OffsetFirstPort: u32,
    ElementSize: u32,
    Ports: [1]NDIS_PORT_CHARACTERISTICS,
};
type
  NDIS_OBJECT_HEADER {.bycopy.} = object
    Type: uint8
    Revision: uint8
    Size: uint16

  NDIS_PORT_CHARACTERISTICS {.bycopy.} = object
    Header: NDIS_OBJECT_HEADER
    PortNumber: uint32
    Flags: uint32
    Type: int32
    MediaConnectState: int32
    XmitLinkSpeed: uint64
    RcvLinkSpeed: uint64
    Direction: int32
    SendControlState: int32
    RcvControlState: int32
    SendAuthorizationState: int32
    RcvAuthorizationState: int32

  NDIS_PORT_ARRAY {.bycopy.} = object
    Header: NDIS_OBJECT_HEADER
    NumberOfPorts: uint32
    OffsetFirstPort: uint32
    ElementSize: uint32
    Ports: array[1, NDIS_PORT_CHARACTERISTICS]
struct NDIS_OBJECT_HEADER
{
    ubyte Type;
    ubyte Revision;
    ushort Size;
}

struct NDIS_PORT_CHARACTERISTICS
{
    NDIS_OBJECT_HEADER Header;
    uint PortNumber;
    uint Flags;
    int Type;
    int MediaConnectState;
    ulong XmitLinkSpeed;
    ulong RcvLinkSpeed;
    int Direction;
    int SendControlState;
    int RcvControlState;
    int SendAuthorizationState;
    int RcvAuthorizationState;
}

struct NDIS_PORT_ARRAY
{
    NDIS_OBJECT_HEADER Header;
    uint NumberOfPorts;
    uint OffsetFirstPort;
    uint ElementSize;
    NDIS_PORT_CHARACTERISTICS[1] Ports;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NDIS_PORT_ARRAY サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; Header : NDIS_OBJECT_HEADER (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; NumberOfPorts : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; OffsetFirstPort : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ElementSize : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Ports : NDIS_PORT_CHARACTERISTICS (+16, 64byte)  varptr(st)+16 を基点に操作(64byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global NDIS_OBJECT_HEADER
    #field byte Type
    #field byte Revision
    #field short Size
#endstruct

#defstruct global NDIS_PORT_CHARACTERISTICS
    #field NDIS_OBJECT_HEADER Header
    #field int PortNumber
    #field int Flags
    #field int Type
    #field int MediaConnectState
    #field int64 XmitLinkSpeed
    #field int64 RcvLinkSpeed
    #field int Direction
    #field int SendControlState
    #field int RcvControlState
    #field int SendAuthorizationState
    #field int RcvAuthorizationState
#endstruct

#defstruct global NDIS_PORT_ARRAY
    #field NDIS_OBJECT_HEADER Header
    #field int NumberOfPorts
    #field int OffsetFirstPort
    #field int ElementSize
    #field NDIS_PORT_CHARACTERISTICS Ports 1
#endstruct

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