ホーム › Storage.Nvme › NVME_DEVICE_SELF_TEST_RESULT_DATA

NVME_DEVICE_SELF_TEST_RESULT_DATA

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
Status	_Status_e__Struct	1	+0	+0	Device Self-Test 操作の状態を示すフィールドを含む Status 構造体です。
SegmentNumber	BYTE	1	+1	+1	Device Self-Test 操作中に障害が発生した最初のセグメントを示します。
ValidDiagnostics	_ValidDiagnostics_e__Struct	1	+2	+2	Device Self-Test 操作における特定のパラメーターの有効性を示すフィールドを含む ValidDiagnostics 構造体です。
Reserved	BYTE	1	+3	+3	ValidDiagnostics 構造体の予約済みフィールドです。
POH	ULONGLONG	8	+4	+4	テスト操作が完了または中止された時点の電源投入時間 (POH: Power On Hours) を示します。
NSID	DWORD	4	+12	+12	名前空間識別子 (NSID) を格納します。このフィールドは、NSIDValid が `1` に設定されている場合にのみ有効です。
FailingLBA	ULONGLONG	8	+16	+16	テストの失敗の原因となった論理ブロックアドレス (LBA) です。このフィールドは、FLBAValid が `1` に設定されている場合にのみ有効です。
StatusCodeType	_StatusCodeType_e__Struct	1	+24	+24	エラーおよび状態に関する情報を保持するフィールドを含むステータスコードタイプ (StatusCodeType) 構造体です。
StatusCode	BYTE	1	+25	+25	ステータスコードに基づく、Device Self-Test 操作のエラーおよび状態に関連する追加情報を格納する StatusCodeType のフィールドです。このフィールドは、SCValid が `1` に設定されている場合にのみ有効です。
VendorSpecific	WORD	2	+26	+26	ベンダー固有のフィールドです。

構造体: _Status_e__Struct x64 1B / x86 1B

フィールド	型	サイズ	x64	x86
_bitfield	BYTE	1	+0	+0

構造体: _ValidDiagnostics_e__Struct x64 1B / x86 1B

フィールド	型	サイズ	x64	x86
_bitfield	BYTE	1	+0	+0

構造体: _StatusCodeType_e__Struct x64 1B / x86 1B

フィールド	型	サイズ	x64	x86
_bitfield	BYTE	1	+0	+0

公式ドキュメント

Device Self-Test 操作の結果に関するデータを格納します。

この構造体は、NVME_DEVICE_SELF_TEST_LOG 構造体の ResultData フィールドで使用されます。

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

各言語での定義

#include <windows.h>

// NVME_DEVICE_SELF_TEST_RESULT_DATA  (x64 28 / x86 28 バイト)
#pragma pack(push, 1)
typedef struct NVME_DEVICE_SELF_TEST_RESULT_DATA {
    _Status_e__Struct Status;
    BYTE SegmentNumber;
    _ValidDiagnostics_e__Struct ValidDiagnostics;
    BYTE Reserved;
    ULONGLONG POH;
    DWORD NSID;
    ULONGLONG FailingLBA;
    _StatusCodeType_e__Struct StatusCodeType;
    BYTE StatusCode;
    WORD VendorSpecific;
} NVME_DEVICE_SELF_TEST_RESULT_DATA;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct NVME_DEVICE_SELF_TEST_RESULT_DATA
{
    public _Status_e__Struct Status;
    public byte SegmentNumber;
    public _ValidDiagnostics_e__Struct ValidDiagnostics;
    public byte Reserved;
    public ulong POH;
    public uint NSID;
    public ulong FailingLBA;
    public _StatusCodeType_e__Struct StatusCodeType;
    public byte StatusCode;
    public ushort VendorSpecific;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure NVME_DEVICE_SELF_TEST_RESULT_DATA
    Public Status As _Status_e__Struct
    Public SegmentNumber As Byte
    Public ValidDiagnostics As _ValidDiagnostics_e__Struct
    Public Reserved As Byte
    Public POH As ULong
    Public NSID As UInteger
    Public FailingLBA As ULong
    Public StatusCodeType As _StatusCodeType_e__Struct
    Public StatusCode As Byte
    Public VendorSpecific As UShort
End Structure

import ctypes
from ctypes import wintypes

class NVME_DEVICE_SELF_TEST_RESULT_DATA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("Status", _Status_e__Struct),
        ("SegmentNumber", ctypes.c_ubyte),
        ("ValidDiagnostics", _ValidDiagnostics_e__Struct),
        ("Reserved", ctypes.c_ubyte),
        ("POH", ctypes.c_ulonglong),
        ("NSID", wintypes.DWORD),
        ("FailingLBA", ctypes.c_ulonglong),
        ("StatusCodeType", _StatusCodeType_e__Struct),
        ("StatusCode", ctypes.c_ubyte),
        ("VendorSpecific", ctypes.c_ushort),
    ]

#[repr(C, packed(1))]
pub struct NVME_DEVICE_SELF_TEST_RESULT_DATA {
    pub Status: _Status_e__Struct,
    pub SegmentNumber: u8,
    pub ValidDiagnostics: _ValidDiagnostics_e__Struct,
    pub Reserved: u8,
    pub POH: u64,
    pub NSID: u32,
    pub FailingLBA: u64,
    pub StatusCodeType: _StatusCodeType_e__Struct,
    pub StatusCode: u8,
    pub VendorSpecific: u16,
}

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

type NVME_DEVICE_SELF_TEST_RESULT_DATA struct {
	Status _Status_e__Struct
	SegmentNumber byte
	ValidDiagnostics _ValidDiagnostics_e__Struct
	Reserved byte
	POH uint64
	NSID uint32
	FailingLBA uint64
	StatusCodeType _StatusCodeType_e__Struct
	StatusCode byte
	VendorSpecific uint16
}

type
  NVME_DEVICE_SELF_TEST_RESULT_DATA = packed record
    Status: _Status_e__Struct;
    SegmentNumber: Byte;
    ValidDiagnostics: _ValidDiagnostics_e__Struct;
    Reserved: Byte;
    POH: UInt64;
    NSID: DWORD;
    FailingLBA: UInt64;
    StatusCodeType: _StatusCodeType_e__Struct;
    StatusCode: Byte;
    VendorSpecific: Word;
  end;

const NVME_DEVICE_SELF_TEST_RESULT_DATA = extern struct {
    Status: _Status_e__Struct,
    SegmentNumber: u8,
    ValidDiagnostics: _ValidDiagnostics_e__Struct,
    Reserved: u8,
    POH: u64,
    NSID: u32,
    FailingLBA: u64,
    StatusCodeType: _StatusCodeType_e__Struct,
    StatusCode: u8,
    VendorSpecific: u16,
};

type
  NVME_DEVICE_SELF_TEST_RESULT_DATA {.packed.} = object
    Status: _Status_e__Struct
    SegmentNumber: uint8
    ValidDiagnostics: _ValidDiagnostics_e__Struct
    Reserved: uint8
    POH: uint64
    NSID: uint32
    FailingLBA: uint64
    StatusCodeType: _StatusCodeType_e__Struct
    StatusCode: uint8
    VendorSpecific: uint16

align(1)
struct NVME_DEVICE_SELF_TEST_RESULT_DATA
{
    _Status_e__Struct Status;
    ubyte SegmentNumber;
    _ValidDiagnostics_e__Struct ValidDiagnostics;
    ubyte Reserved;
    ulong POH;
    uint NSID;
    ulong FailingLBA;
    _StatusCodeType_e__Struct StatusCodeType;
    ubyte StatusCode;
    ushort VendorSpecific;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NVME_DEVICE_SELF_TEST_RESULT_DATA サイズ: 28 バイト(x64)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; Status : _Status_e__Struct (+0, 1byte)  varptr(st)+0 を基点に操作(1byte:入れ子/配列)
; SegmentNumber : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; ValidDiagnostics : _ValidDiagnostics_e__Struct (+2, 1byte)  varptr(st)+2 を基点に操作(1byte:入れ子/配列)
; Reserved : BYTE (+3, 1byte)  poke st,3,値  /  値 = peek(st,3)
; POH : ULONGLONG (+4, 8byte)  qpoke st,4,値 / qpeek(st,4)  ※IronHSPのみ。3.7/3.8は lpoke st,4,下位 : lpoke st,8,上位
; NSID : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; FailingLBA : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; StatusCodeType : _StatusCodeType_e__Struct (+24, 1byte)  varptr(st)+24 を基点に操作(1byte:入れ子/配列)
; StatusCode : BYTE (+25, 1byte)  poke st,25,値  /  値 = peek(st,25)
; VendorSpecific : WORD (+26, 2byte)  wpoke st,26,値  /  値 = wpeek(st,26)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NVME_DEVICE_SELF_TEST_RESULT_DATA, pack=1
    #field _Status_e__Struct Status
    #field byte SegmentNumber
    #field _ValidDiagnostics_e__Struct ValidDiagnostics
    #field byte Reserved
    #field int64 POH
    #field int NSID
    #field int64 FailingLBA
    #field _StatusCodeType_e__Struct StatusCodeType
    #field byte StatusCode
    #field short VendorSpecific
#endstruct

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