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

NVME_COMMAND

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

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

フィールド

フィールドサイズx64x86説明
CDW0NVME_COMMAND_DWORD04+0+0オペコードやコマンド識別子を格納するコマンドDWord0である。
NSIDDWORD4+4+4コマンド対象の名前空間識別子(Namespace Identifier)を表す32ビット値である。0xFFFFFFFFは全名前空間を示す。
Reserved0DWORD8+8+8将来の拡張用に予約された32ビットフィールドである。
MPTRULONGLONG8+16+16メタデータの物理アドレスを指すメタデータポインタ(Metadata Pointer)を表す64ビット値である。
Anonymous_Anonymous_e__Union16+24+24PRPエントリまたはSGL記述子のいずれかでデータ転送先を指定するデータポインタ共用体である。
u_u_e__Union8/4+40+40コマンド種別に応じたコマンドDWord10〜15を格納する共用体である。

共用体: _Anonymous_e__Union x64 16B / x86 16B

フィールドサイズx64x86説明
Anonymous_Anonymous_e__Struct8/4+0+0PRPエントリまたはSGL記述子のいずれかでデータ転送先を指定するデータポインタ共用体である。
SGL1ULONGLONG16+0+0

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

フィールドサイズx64x86
GENERAL_GENERAL_e__Struct8/4+0+0
IDENTIFY_IDENTIFY_e__Struct8/4+0+0
ABORT_ABORT_e__Struct8/4+0+0
GETFEATURES_GETFEATURES_e__Struct8/4+0+0
SETFEATURES_SETFEATURES_e__Struct8/4+0+0
GETLOGPAGE_GETLOGPAGE_e__Struct8/4+0+0
CREATEIOCQ_CREATEIOCQ_e__Struct8/4+0+0
CREATEIOSQ_CREATEIOSQ_e__Struct8/4+0+0
DELETEIOQUEUE_DELETEIOQUEUE_e__Struct8/4+0+0
DATASETMANAGEMENT_DATASETMANAGEMENT_e__Struct8/4+0+0
SECURITYSEND_SECURITYSEND_e__Struct8/4+0+0
SECURITYRECEIVE_SECURITYRECEIVE_e__Struct8/4+0+0
FIRMWAREDOWNLOAD_FIRMWAREDOWNLOAD_e__Struct8/4+0+0
FIRMWAREACTIVATE_FIRMWAREACTIVATE_e__Struct8/4+0+0
FORMATNVM_FORMATNVM_e__Struct8/4+0+0
DIRECTIVERECEIVE_DIRECTIVERECEIVE_e__Struct8/4+0+0
DIRECTIVESEND_DIRECTIVESEND_e__Struct8/4+0+0
SANITIZE_SANITIZE_e__Struct8/4+0+0
READWRITE_READWRITE_e__Struct8/4+0+0
RESERVATIONACQUIRE_RESERVATIONACQUIRE_e__Struct8/4+0+0
RESERVATIONREGISTER_RESERVATIONREGISTER_e__Struct8/4+0+0
RESERVATIONRELEASE_RESERVATIONRELEASE_e__Struct8/4+0+0
RESERVATIONREPORT_RESERVATIONREPORT_e__Struct8/4+0+0
ZONEMANAGEMENTSEND_ZONEMANAGEMENTSEND_e__Struct8/4+0+0
ZONEMANAGEMENTRECEIVE_ZONEMANAGEMENTRECEIVE_e__Struct8/4+0+0
ZONEAPPEND_ZONEAPPEND_e__Struct8/4+0+0
DEVICESELFTEST_DEVICESELFTEST_e__Struct8/4+0+0
DISCOVERYINFOMGMT_DISCOVERYINFOMGMT_e__Struct8/4+0+0
VENDORSPECIFIC_VENDORSPECIFIC_e__Struct8/4+0+0
VERIFYCOMMAND_VERIFYCOMMAND_e__Struct8/4+0+0

各言語での定義

#include <windows.h>

// NVME_COMMAND_DWORD0  (x64 4 / x86 4 バイト)
typedef struct NVME_COMMAND_DWORD0 {
    _Anonymous_e__Struct Anonymous;
    DWORD AsUlong;
} NVME_COMMAND_DWORD0;

// NVME_COMMAND  (x64 48 / x86 48 バイト)
typedef struct NVME_COMMAND {
    NVME_COMMAND_DWORD0 CDW0;
    DWORD NSID;
    DWORD Reserved0[2];
    ULONGLONG MPTR;
    _Anonymous_e__Union Anonymous;
    _u_e__Union u;
} NVME_COMMAND;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NVME_COMMAND_DWORD0
{
    public _Anonymous_e__Struct Anonymous;
    public uint AsUlong;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NVME_COMMAND
{
    public NVME_COMMAND_DWORD0 CDW0;
    public uint NSID;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)] public uint[] Reserved0;
    public ulong MPTR;
    public _Anonymous_e__Union Anonymous;
    public _u_e__Union u;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NVME_COMMAND_DWORD0
    Public Anonymous As _Anonymous_e__Struct
    Public AsUlong As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NVME_COMMAND
    Public CDW0 As NVME_COMMAND_DWORD0
    Public NSID As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=2)> Public Reserved0() As UInteger
    Public MPTR As ULong
    Public Anonymous As _Anonymous_e__Union
    Public u As _u_e__Union
End Structure
import ctypes
from ctypes import wintypes

class NVME_COMMAND_DWORD0(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Struct),
        ("AsUlong", wintypes.DWORD),
    ]

class NVME_COMMAND(ctypes.Structure):
    _fields_ = [
        ("CDW0", NVME_COMMAND_DWORD0),
        ("NSID", wintypes.DWORD),
        ("Reserved0", wintypes.DWORD * 2),
        ("MPTR", ctypes.c_ulonglong),
        ("Anonymous", _Anonymous_e__Union),
        ("u", _u_e__Union),
    ]
#[repr(C)]
pub struct NVME_COMMAND_DWORD0 {
    pub Anonymous: _Anonymous_e__Struct,
    pub AsUlong: u32,
}

#[repr(C)]
pub struct NVME_COMMAND {
    pub CDW0: NVME_COMMAND_DWORD0,
    pub NSID: u32,
    pub Reserved0: [u32; 2],
    pub MPTR: u64,
    pub Anonymous: _Anonymous_e__Union,
    pub u: _u_e__Union,
}
import "golang.org/x/sys/windows"

type NVME_COMMAND_DWORD0 struct {
	Anonymous _Anonymous_e__Struct
	AsUlong uint32
}

type NVME_COMMAND struct {
	CDW0 NVME_COMMAND_DWORD0
	NSID uint32
	Reserved0 [2]uint32
	MPTR uint64
	Anonymous _Anonymous_e__Union
	u _u_e__Union
}
type
  NVME_COMMAND_DWORD0 = record
    Anonymous: _Anonymous_e__Struct;
    AsUlong: DWORD;
  end;

  NVME_COMMAND = record
    CDW0: NVME_COMMAND_DWORD0;
    NSID: DWORD;
    Reserved0: array[0..1] of DWORD;
    MPTR: UInt64;
    Anonymous: _Anonymous_e__Union;
    u: _u_e__Union;
  end;
const NVME_COMMAND_DWORD0 = extern struct {
    Anonymous: _Anonymous_e__Struct,
    AsUlong: u32,
};

const NVME_COMMAND = extern struct {
    CDW0: NVME_COMMAND_DWORD0,
    NSID: u32,
    Reserved0: [2]u32,
    MPTR: u64,
    Anonymous: _Anonymous_e__Union,
    u: _u_e__Union,
};
type
  NVME_COMMAND_DWORD0 {.bycopy.} = object
    Anonymous: _Anonymous_e__Struct
    AsUlong: uint32

  NVME_COMMAND {.bycopy.} = object
    CDW0: NVME_COMMAND_DWORD0
    NSID: uint32
    Reserved0: array[2, uint32]
    MPTR: uint64
    Anonymous: _Anonymous_e__Union
    u: _u_e__Union
struct NVME_COMMAND_DWORD0
{
    _Anonymous_e__Struct Anonymous;
    uint AsUlong;
}

struct NVME_COMMAND
{
    NVME_COMMAND_DWORD0 CDW0;
    uint NSID;
    uint[2] Reserved0;
    ulong MPTR;
    _Anonymous_e__Union Anonymous;
    _u_e__Union u;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NVME_COMMAND サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; CDW0 : NVME_COMMAND_DWORD0 (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; NSID : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Reserved0 : DWORD (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; MPTR : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Anonymous : _Anonymous_e__Union (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; u : _u_e__Union (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NVME_COMMAND サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; CDW0 : NVME_COMMAND_DWORD0 (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; NSID : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Reserved0 : DWORD (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; MPTR : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Anonymous : _Anonymous_e__Union (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; u : _u_e__Union (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NVME_COMMAND
    #field byte CDW0 4
    #field int NSID
    #field int Reserved0 2
    #field int64 MPTR
    #field byte Anonymous 16
    #field byte u 8
#endstruct

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