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

NVME_REPORT_ZONE_INFO

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

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

フィールド

フィールド型サイズx64x86説明
ZoneCountULONGLONG8+0+0レポートに含まれるゾーン記述子の数(Number of Zones)を表す64ビット値である。
ReservedULONGLONG56+8+8将来の拡張用に予約された未使用フィールドである。
ZoneDescriptorNVME_ZONE_DESCRIPTOR64+64+64各ゾーンの状態や容量を格納するゾーン記述子配列の先頭要素である。

各言語での定義

#include <windows.h>

// NVME_ZONE_DESCRIPTOR  (x64 64 / x86 64 バイト)
typedef struct NVME_ZONE_DESCRIPTOR {
    _Anonymous1_e__Struct Anonymous1;
    _Anonymous2_e__Struct Anonymous2;
    _ZA_e__Struct ZA;
    BYTE Reserved3[5];
    ULONGLONG ZCAP;
    ULONGLONG ZSLBA;
    ULONGLONG WritePointer;
    BYTE Reserved4[32];
} NVME_ZONE_DESCRIPTOR;

// NVME_REPORT_ZONE_INFO  (x64 128 / x86 128 バイト)
typedef struct NVME_REPORT_ZONE_INFO {
    ULONGLONG ZoneCount;
    ULONGLONG Reserved[7];
    NVME_ZONE_DESCRIPTOR ZoneDescriptor[1];
} NVME_REPORT_ZONE_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NVME_ZONE_DESCRIPTOR
{
    public _Anonymous1_e__Struct Anonymous1;
    public _Anonymous2_e__Struct Anonymous2;
    public _ZA_e__Struct ZA;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 5)] public byte[] Reserved3;
    public ulong ZCAP;
    public ulong ZSLBA;
    public ulong WritePointer;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 32)] public byte[] Reserved4;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NVME_REPORT_ZONE_INFO
{
    public ulong ZoneCount;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 7)] public ulong[] Reserved;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public NVME_ZONE_DESCRIPTOR[] ZoneDescriptor;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NVME_ZONE_DESCRIPTOR
    Public Anonymous1 As _Anonymous1_e__Struct
    Public Anonymous2 As _Anonymous2_e__Struct
    Public ZA As _ZA_e__Struct
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=5)> Public Reserved3() As Byte
    Public ZCAP As ULong
    Public ZSLBA As ULong
    Public WritePointer As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=32)> Public Reserved4() As Byte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NVME_REPORT_ZONE_INFO
    Public ZoneCount As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=7)> Public Reserved() As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public ZoneDescriptor() As NVME_ZONE_DESCRIPTOR
End Structure
import ctypes
from ctypes import wintypes

class NVME_ZONE_DESCRIPTOR(ctypes.Structure):
    _fields_ = [
        ("Anonymous1", _Anonymous1_e__Struct),
        ("Anonymous2", _Anonymous2_e__Struct),
        ("ZA", _ZA_e__Struct),
        ("Reserved3", ctypes.c_ubyte * 5),
        ("ZCAP", ctypes.c_ulonglong),
        ("ZSLBA", ctypes.c_ulonglong),
        ("WritePointer", ctypes.c_ulonglong),
        ("Reserved4", ctypes.c_ubyte * 32),
    ]

class NVME_REPORT_ZONE_INFO(ctypes.Structure):
    _fields_ = [
        ("ZoneCount", ctypes.c_ulonglong),
        ("Reserved", ctypes.c_ulonglong * 7),
        ("ZoneDescriptor", NVME_ZONE_DESCRIPTOR * 1),
    ]
#[repr(C)]
pub struct NVME_ZONE_DESCRIPTOR {
    pub Anonymous1: _Anonymous1_e__Struct,
    pub Anonymous2: _Anonymous2_e__Struct,
    pub ZA: _ZA_e__Struct,
    pub Reserved3: [u8; 5],
    pub ZCAP: u64,
    pub ZSLBA: u64,
    pub WritePointer: u64,
    pub Reserved4: [u8; 32],
}

#[repr(C)]
pub struct NVME_REPORT_ZONE_INFO {
    pub ZoneCount: u64,
    pub Reserved: [u64; 7],
    pub ZoneDescriptor: [NVME_ZONE_DESCRIPTOR; 1],
}
import "golang.org/x/sys/windows"

type NVME_ZONE_DESCRIPTOR struct {
	Anonymous1 _Anonymous1_e__Struct
	Anonymous2 _Anonymous2_e__Struct
	ZA _ZA_e__Struct
	Reserved3 [5]byte
	ZCAP uint64
	ZSLBA uint64
	WritePointer uint64
	Reserved4 [32]byte
}

type NVME_REPORT_ZONE_INFO struct {
	ZoneCount uint64
	Reserved [7]uint64
	ZoneDescriptor [1]NVME_ZONE_DESCRIPTOR
}
type
  NVME_ZONE_DESCRIPTOR = record
    Anonymous1: _Anonymous1_e__Struct;
    Anonymous2: _Anonymous2_e__Struct;
    ZA: _ZA_e__Struct;
    Reserved3: array[0..4] of Byte;
    ZCAP: UInt64;
    ZSLBA: UInt64;
    WritePointer: UInt64;
    Reserved4: array[0..31] of Byte;
  end;

  NVME_REPORT_ZONE_INFO = record
    ZoneCount: UInt64;
    Reserved: array[0..6] of UInt64;
    ZoneDescriptor: array[0..0] of NVME_ZONE_DESCRIPTOR;
  end;
const NVME_ZONE_DESCRIPTOR = extern struct {
    Anonymous1: _Anonymous1_e__Struct,
    Anonymous2: _Anonymous2_e__Struct,
    ZA: _ZA_e__Struct,
    Reserved3: [5]u8,
    ZCAP: u64,
    ZSLBA: u64,
    WritePointer: u64,
    Reserved4: [32]u8,
};

const NVME_REPORT_ZONE_INFO = extern struct {
    ZoneCount: u64,
    Reserved: [7]u64,
    ZoneDescriptor: [1]NVME_ZONE_DESCRIPTOR,
};
type
  NVME_ZONE_DESCRIPTOR {.bycopy.} = object
    Anonymous1: _Anonymous1_e__Struct
    Anonymous2: _Anonymous2_e__Struct
    ZA: _ZA_e__Struct
    Reserved3: array[5, uint8]
    ZCAP: uint64
    ZSLBA: uint64
    WritePointer: uint64
    Reserved4: array[32, uint8]

  NVME_REPORT_ZONE_INFO {.bycopy.} = object
    ZoneCount: uint64
    Reserved: array[7, uint64]
    ZoneDescriptor: array[1, NVME_ZONE_DESCRIPTOR]
struct NVME_ZONE_DESCRIPTOR
{
    _Anonymous1_e__Struct Anonymous1;
    _Anonymous2_e__Struct Anonymous2;
    _ZA_e__Struct ZA;
    ubyte[5] Reserved3;
    ulong ZCAP;
    ulong ZSLBA;
    ulong WritePointer;
    ubyte[32] Reserved4;
}

struct NVME_REPORT_ZONE_INFO
{
    ulong ZoneCount;
    ulong[7] Reserved;
    NVME_ZONE_DESCRIPTOR[1] ZoneDescriptor;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NVME_REPORT_ZONE_INFO サイズ: 128 バイト(x64)
dim st, 32    ; 4byte整数×32(構造体サイズ 128 / 4 切り上げ)
; ZoneCount : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; Reserved : ULONGLONG (+8, 56byte)  varptr(st)+8 を基点に操作(56byte:入れ子/配列)
; ZoneDescriptor : NVME_ZONE_DESCRIPTOR (+64, 64byte)  varptr(st)+64 を基点に操作(64byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global NVME_ZONE_DESCRIPTOR
    #field _Anonymous1_e__Struct Anonymous1
    #field _Anonymous2_e__Struct Anonymous2
    #field _ZA_e__Struct ZA
    #field byte Reserved3 5
    #field int64 ZCAP
    #field int64 ZSLBA
    #field int64 WritePointer
    #field byte Reserved4 32
#endstruct

#defstruct global NVME_REPORT_ZONE_INFO
    #field int64 ZoneCount
    #field int64 Reserved 7
    #field NVME_ZONE_DESCRIPTOR ZoneDescriptor 1
#endstruct

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