Win32 API 日本語リファレンス
ホーム › Storage.Nvme › NVME_EXTENDED_DISCOVERY_ENTRY

NVME_EXTENDED_DISCOVERY_ENTRY

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

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

フィールド

フィールド型サイズx64x86説明
TRTYPEBYTE1+0+0トランスポート種別(Transport Type)を表す8ビット値である。
ADRFAMBYTE1+1+1アドレスファミリ(Address Family)を表す8ビット値である。
SUBTYPEBYTE1+2+2サブシステムの種別(Subsystem Type)を表す8ビット値である。
TREQ_TREQ_e__Union8/4+8+4トランスポート要件(Transport Requirements)を示す共用体である。
PORTIDWORD2+16+8ポート識別子(Port Identifier)を表す16ビット値である。
CNTLIDWORD2+18+10コントローラ識別子(Controller ID)を表す16ビット値である。
ASQSZWORD2+20+12管理送信キューの最大サイズ(Admin SQ Size)を表す16ビット値である。
EFLAGS_EFLAGS_e__Union8/4+24+16エントリのフラグ(Entry Flags)を示す共用体である。
Reserved0BYTE20+32+20将来の拡張用に予約された未使用バイト列である。
TRSVCIDBYTE32+52+40トランスポートサービス識別子(Transport Service ID)を表す文字列バイト列である。
Reserved1BYTE192+84+72将来の拡張用に予約された未使用バイト列である。
NQNBYTE256+276+264サブシステムのNVMe修飾名(NVMe Qualified Name)を表す文字列バイト列である。
TRADDRBYTE256+532+520トランスポートアドレス(Transport Address)を表す文字列バイト列である。
TSASBYTE256+788+776トランスポート固有のアドレスサブタイプ(Transport Specific Address Subtype)を表すバイト列である。
TELDWORD4+1044+1032拡張エントリ全体の長さ(Total Entry Length)をバイト単位で表す32ビット値である。
NUMEXATWORD2+1048+1036このエントリに含まれる拡張属性の数(Number of Extended Attributes)を表す16ビット値である。
Reserved2WORD2+1050+1038将来の拡張用に予約された16ビットフィールドである。

共用体: _TREQ_e__Union x64 8B / x86 4B

フィールド型サイズx64x86
Anonymous_Anonymous_e__Struct8/4+0+0
AsUcharBYTE1+0+0

共用体: _EFLAGS_e__Union x64 8B / x86 4B

フィールド型サイズx64x86
Anonymous_Anonymous_e__Struct8/4+0+0
AsUshortWORD2+0+0

各言語での定義

#include <windows.h>

// NVME_EXTENDED_DISCOVERY_ENTRY  (x64 1056 / x86 1040 バイト)
typedef struct NVME_EXTENDED_DISCOVERY_ENTRY {
    BYTE TRTYPE;
    BYTE ADRFAM;
    BYTE SUBTYPE;
    _TREQ_e__Union TREQ;
    WORD PORTID;
    WORD CNTLID;
    WORD ASQSZ;
    _EFLAGS_e__Union EFLAGS;
    BYTE Reserved0[20];
    BYTE TRSVCID[32];
    BYTE Reserved1[192];
    BYTE NQN[256];
    BYTE TRADDR[256];
    BYTE TSAS[256];
    DWORD TEL;
    WORD NUMEXAT;
    WORD Reserved2;
} NVME_EXTENDED_DISCOVERY_ENTRY;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NVME_EXTENDED_DISCOVERY_ENTRY
{
    public byte TRTYPE;
    public byte ADRFAM;
    public byte SUBTYPE;
    public _TREQ_e__Union TREQ;
    public ushort PORTID;
    public ushort CNTLID;
    public ushort ASQSZ;
    public _EFLAGS_e__Union EFLAGS;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 20)] public byte[] Reserved0;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 32)] public byte[] TRSVCID;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 192)] public byte[] Reserved1;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] public byte[] NQN;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] public byte[] TRADDR;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] public byte[] TSAS;
    public uint TEL;
    public ushort NUMEXAT;
    public ushort Reserved2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NVME_EXTENDED_DISCOVERY_ENTRY
    Public TRTYPE As Byte
    Public ADRFAM As Byte
    Public SUBTYPE As Byte
    Public TREQ As _TREQ_e__Union
    Public PORTID As UShort
    Public CNTLID As UShort
    Public ASQSZ As UShort
    Public EFLAGS As _EFLAGS_e__Union
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=20)> Public Reserved0() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=32)> Public TRSVCID() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=192)> Public Reserved1() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=256)> Public NQN() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=256)> Public TRADDR() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=256)> Public TSAS() As Byte
    Public TEL As UInteger
    Public NUMEXAT As UShort
    Public Reserved2 As UShort
End Structure
import ctypes
from ctypes import wintypes

class NVME_EXTENDED_DISCOVERY_ENTRY(ctypes.Structure):
    _fields_ = [
        ("TRTYPE", ctypes.c_ubyte),
        ("ADRFAM", ctypes.c_ubyte),
        ("SUBTYPE", ctypes.c_ubyte),
        ("TREQ", _TREQ_e__Union),
        ("PORTID", ctypes.c_ushort),
        ("CNTLID", ctypes.c_ushort),
        ("ASQSZ", ctypes.c_ushort),
        ("EFLAGS", _EFLAGS_e__Union),
        ("Reserved0", ctypes.c_ubyte * 20),
        ("TRSVCID", ctypes.c_ubyte * 32),
        ("Reserved1", ctypes.c_ubyte * 192),
        ("NQN", ctypes.c_ubyte * 256),
        ("TRADDR", ctypes.c_ubyte * 256),
        ("TSAS", ctypes.c_ubyte * 256),
        ("TEL", wintypes.DWORD),
        ("NUMEXAT", ctypes.c_ushort),
        ("Reserved2", ctypes.c_ushort),
    ]
#[repr(C)]
pub struct NVME_EXTENDED_DISCOVERY_ENTRY {
    pub TRTYPE: u8,
    pub ADRFAM: u8,
    pub SUBTYPE: u8,
    pub TREQ: _TREQ_e__Union,
    pub PORTID: u16,
    pub CNTLID: u16,
    pub ASQSZ: u16,
    pub EFLAGS: _EFLAGS_e__Union,
    pub Reserved0: [u8; 20],
    pub TRSVCID: [u8; 32],
    pub Reserved1: [u8; 192],
    pub NQN: [u8; 256],
    pub TRADDR: [u8; 256],
    pub TSAS: [u8; 256],
    pub TEL: u32,
    pub NUMEXAT: u16,
    pub Reserved2: u16,
}
import "golang.org/x/sys/windows"

type NVME_EXTENDED_DISCOVERY_ENTRY struct {
	TRTYPE byte
	ADRFAM byte
	SUBTYPE byte
	TREQ _TREQ_e__Union
	PORTID uint16
	CNTLID uint16
	ASQSZ uint16
	EFLAGS _EFLAGS_e__Union
	Reserved0 [20]byte
	TRSVCID [32]byte
	Reserved1 [192]byte
	NQN [256]byte
	TRADDR [256]byte
	TSAS [256]byte
	TEL uint32
	NUMEXAT uint16
	Reserved2 uint16
}
type
  NVME_EXTENDED_DISCOVERY_ENTRY = record
    TRTYPE: Byte;
    ADRFAM: Byte;
    SUBTYPE: Byte;
    TREQ: _TREQ_e__Union;
    PORTID: Word;
    CNTLID: Word;
    ASQSZ: Word;
    EFLAGS: _EFLAGS_e__Union;
    Reserved0: array[0..19] of Byte;
    TRSVCID: array[0..31] of Byte;
    Reserved1: array[0..191] of Byte;
    NQN: array[0..255] of Byte;
    TRADDR: array[0..255] of Byte;
    TSAS: array[0..255] of Byte;
    TEL: DWORD;
    NUMEXAT: Word;
    Reserved2: Word;
  end;
const NVME_EXTENDED_DISCOVERY_ENTRY = extern struct {
    TRTYPE: u8,
    ADRFAM: u8,
    SUBTYPE: u8,
    TREQ: _TREQ_e__Union,
    PORTID: u16,
    CNTLID: u16,
    ASQSZ: u16,
    EFLAGS: _EFLAGS_e__Union,
    Reserved0: [20]u8,
    TRSVCID: [32]u8,
    Reserved1: [192]u8,
    NQN: [256]u8,
    TRADDR: [256]u8,
    TSAS: [256]u8,
    TEL: u32,
    NUMEXAT: u16,
    Reserved2: u16,
};
type
  NVME_EXTENDED_DISCOVERY_ENTRY {.bycopy.} = object
    TRTYPE: uint8
    ADRFAM: uint8
    SUBTYPE: uint8
    TREQ: _TREQ_e__Union
    PORTID: uint16
    CNTLID: uint16
    ASQSZ: uint16
    EFLAGS: _EFLAGS_e__Union
    Reserved0: array[20, uint8]
    TRSVCID: array[32, uint8]
    Reserved1: array[192, uint8]
    NQN: array[256, uint8]
    TRADDR: array[256, uint8]
    TSAS: array[256, uint8]
    TEL: uint32
    NUMEXAT: uint16
    Reserved2: uint16
struct NVME_EXTENDED_DISCOVERY_ENTRY
{
    ubyte TRTYPE;
    ubyte ADRFAM;
    ubyte SUBTYPE;
    _TREQ_e__Union TREQ;
    ushort PORTID;
    ushort CNTLID;
    ushort ASQSZ;
    _EFLAGS_e__Union EFLAGS;
    ubyte[20] Reserved0;
    ubyte[32] TRSVCID;
    ubyte[192] Reserved1;
    ubyte[256] NQN;
    ubyte[256] TRADDR;
    ubyte[256] TSAS;
    uint TEL;
    ushort NUMEXAT;
    ushort Reserved2;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NVME_EXTENDED_DISCOVERY_ENTRY サイズ: 1040 バイト(x86)
dim st, 260    ; 4byte整数×260(構造体サイズ 1040 / 4 切り上げ)
; TRTYPE : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; ADRFAM : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; SUBTYPE : BYTE (+2, 1byte)  poke st,2,値  /  値 = peek(st,2)
; TREQ : _TREQ_e__Union (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; PORTID : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; CNTLID : WORD (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; ASQSZ : WORD (+12, 2byte)  wpoke st,12,値  /  値 = wpeek(st,12)
; EFLAGS : _EFLAGS_e__Union (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; Reserved0 : BYTE (+20, 20byte)  varptr(st)+20 を基点に操作(20byte:入れ子/配列)
; TRSVCID : BYTE (+40, 32byte)  varptr(st)+40 を基点に操作(32byte:入れ子/配列)
; Reserved1 : BYTE (+72, 192byte)  varptr(st)+72 を基点に操作(192byte:入れ子/配列)
; NQN : BYTE (+264, 256byte)  varptr(st)+264 を基点に操作(256byte:入れ子/配列)
; TRADDR : BYTE (+520, 256byte)  varptr(st)+520 を基点に操作(256byte:入れ子/配列)
; TSAS : BYTE (+776, 256byte)  varptr(st)+776 を基点に操作(256byte:入れ子/配列)
; TEL : DWORD (+1032, 4byte)  st.258 = 値  /  値 = st.258   (lpoke/lpeek も可)
; NUMEXAT : WORD (+1036, 2byte)  wpoke st,1036,値  /  値 = wpeek(st,1036)
; Reserved2 : WORD (+1038, 2byte)  wpoke st,1038,値  /  値 = wpeek(st,1038)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NVME_EXTENDED_DISCOVERY_ENTRY サイズ: 1056 バイト(x64)
dim st, 264    ; 4byte整数×264(構造体サイズ 1056 / 4 切り上げ)
; TRTYPE : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; ADRFAM : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; SUBTYPE : BYTE (+2, 1byte)  poke st,2,値  /  値 = peek(st,2)
; TREQ : _TREQ_e__Union (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; PORTID : WORD (+16, 2byte)  wpoke st,16,値  /  値 = wpeek(st,16)
; CNTLID : WORD (+18, 2byte)  wpoke st,18,値  /  値 = wpeek(st,18)
; ASQSZ : WORD (+20, 2byte)  wpoke st,20,値  /  値 = wpeek(st,20)
; EFLAGS : _EFLAGS_e__Union (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; Reserved0 : BYTE (+32, 20byte)  varptr(st)+32 を基点に操作(20byte:入れ子/配列)
; TRSVCID : BYTE (+52, 32byte)  varptr(st)+52 を基点に操作(32byte:入れ子/配列)
; Reserved1 : BYTE (+84, 192byte)  varptr(st)+84 を基点に操作(192byte:入れ子/配列)
; NQN : BYTE (+276, 256byte)  varptr(st)+276 を基点に操作(256byte:入れ子/配列)
; TRADDR : BYTE (+532, 256byte)  varptr(st)+532 を基点に操作(256byte:入れ子/配列)
; TSAS : BYTE (+788, 256byte)  varptr(st)+788 を基点に操作(256byte:入れ子/配列)
; TEL : DWORD (+1044, 4byte)  st.261 = 値  /  値 = st.261   (lpoke/lpeek も可)
; NUMEXAT : WORD (+1048, 2byte)  wpoke st,1048,値  /  値 = wpeek(st,1048)
; Reserved2 : WORD (+1050, 2byte)  wpoke st,1050,値  /  値 = wpeek(st,1050)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NVME_EXTENDED_DISCOVERY_ENTRY
    #field byte TRTYPE
    #field byte ADRFAM
    #field byte SUBTYPE
    #field byte TREQ 8
    #field short PORTID
    #field short CNTLID
    #field short ASQSZ
    #field byte EFLAGS 8
    #field byte Reserved0 20
    #field byte TRSVCID 32
    #field byte Reserved1 192
    #field byte NQN 256
    #field byte TRADDR 256
    #field byte TSAS 256
    #field int TEL
    #field short NUMEXAT
    #field short Reserved2
#endstruct

stdim st, NVME_EXTENDED_DISCOVERY_ENTRY        ; NSTRUCT 変数を確保
st->TRTYPE = 100
mes "TRTYPE=" + st->TRTYPE
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。