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

ATA_PASS_THROUGH_EX

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

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

フィールド

フィールド型サイズx64x86説明
LengthWORD2+0+0この構造体のバイト長。
AtaFlagsWORD2+2+2ATAコマンドの制御フラグ(データ方向/DMA等のATA_FLAGS_*)。
PathIdBYTE1+4+4対象デバイスのバス(パス)番号。
TargetIdBYTE1+5+5対象デバイスのターゲットID。
LunBYTE1+6+6対象デバイスの論理ユニット番号(LUN)。
ReservedAsUcharBYTE1+7+7予約フィールド(BYTE)。
DataTransferLengthDWORD4+8+8転送するデータのバイト長。
TimeOutValueDWORD4+12+12コマンドのタイムアウト秒数。
ReservedAsUlongDWORD4+16+16予約フィールド(DWORD)。
DataBufferOffsetUINT_PTR8/4+24+20構造体先頭からデータバッファまでのオフセット(ポインタ幅)。
PreviousTaskFileBYTE8+32+2448ビットコマンド用の前タスクファイルレジスタ値(8バイト)。
CurrentTaskFileBYTE8+40+32ATAタスクファイルレジスタの現在値(8バイト)。

各言語での定義

#include <windows.h>

// ATA_PASS_THROUGH_EX  (x64 48 / x86 40 バイト)
typedef struct ATA_PASS_THROUGH_EX {
    WORD Length;
    WORD AtaFlags;
    BYTE PathId;
    BYTE TargetId;
    BYTE Lun;
    BYTE ReservedAsUchar;
    DWORD DataTransferLength;
    DWORD TimeOutValue;
    DWORD ReservedAsUlong;
    UINT_PTR DataBufferOffset;
    BYTE PreviousTaskFile[8];
    BYTE CurrentTaskFile[8];
} ATA_PASS_THROUGH_EX;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ATA_PASS_THROUGH_EX
{
    public ushort Length;
    public ushort AtaFlags;
    public byte PathId;
    public byte TargetId;
    public byte Lun;
    public byte ReservedAsUchar;
    public uint DataTransferLength;
    public uint TimeOutValue;
    public uint ReservedAsUlong;
    public UIntPtr DataBufferOffset;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public byte[] PreviousTaskFile;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public byte[] CurrentTaskFile;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ATA_PASS_THROUGH_EX
    Public Length As UShort
    Public AtaFlags As UShort
    Public PathId As Byte
    Public TargetId As Byte
    Public Lun As Byte
    Public ReservedAsUchar As Byte
    Public DataTransferLength As UInteger
    Public TimeOutValue As UInteger
    Public ReservedAsUlong As UInteger
    Public DataBufferOffset As UIntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public PreviousTaskFile() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public CurrentTaskFile() As Byte
End Structure
import ctypes
from ctypes import wintypes

class ATA_PASS_THROUGH_EX(ctypes.Structure):
    _fields_ = [
        ("Length", ctypes.c_ushort),
        ("AtaFlags", ctypes.c_ushort),
        ("PathId", ctypes.c_ubyte),
        ("TargetId", ctypes.c_ubyte),
        ("Lun", ctypes.c_ubyte),
        ("ReservedAsUchar", ctypes.c_ubyte),
        ("DataTransferLength", wintypes.DWORD),
        ("TimeOutValue", wintypes.DWORD),
        ("ReservedAsUlong", wintypes.DWORD),
        ("DataBufferOffset", ctypes.c_size_t),
        ("PreviousTaskFile", ctypes.c_ubyte * 8),
        ("CurrentTaskFile", ctypes.c_ubyte * 8),
    ]
#[repr(C)]
pub struct ATA_PASS_THROUGH_EX {
    pub Length: u16,
    pub AtaFlags: u16,
    pub PathId: u8,
    pub TargetId: u8,
    pub Lun: u8,
    pub ReservedAsUchar: u8,
    pub DataTransferLength: u32,
    pub TimeOutValue: u32,
    pub ReservedAsUlong: u32,
    pub DataBufferOffset: usize,
    pub PreviousTaskFile: [u8; 8],
    pub CurrentTaskFile: [u8; 8],
}
import "golang.org/x/sys/windows"

type ATA_PASS_THROUGH_EX struct {
	Length uint16
	AtaFlags uint16
	PathId byte
	TargetId byte
	Lun byte
	ReservedAsUchar byte
	DataTransferLength uint32
	TimeOutValue uint32
	ReservedAsUlong uint32
	DataBufferOffset uintptr
	PreviousTaskFile [8]byte
	CurrentTaskFile [8]byte
}
type
  ATA_PASS_THROUGH_EX = record
    Length: Word;
    AtaFlags: Word;
    PathId: Byte;
    TargetId: Byte;
    Lun: Byte;
    ReservedAsUchar: Byte;
    DataTransferLength: DWORD;
    TimeOutValue: DWORD;
    ReservedAsUlong: DWORD;
    DataBufferOffset: NativeUInt;
    PreviousTaskFile: array[0..7] of Byte;
    CurrentTaskFile: array[0..7] of Byte;
  end;
const ATA_PASS_THROUGH_EX = extern struct {
    Length: u16,
    AtaFlags: u16,
    PathId: u8,
    TargetId: u8,
    Lun: u8,
    ReservedAsUchar: u8,
    DataTransferLength: u32,
    TimeOutValue: u32,
    ReservedAsUlong: u32,
    DataBufferOffset: usize,
    PreviousTaskFile: [8]u8,
    CurrentTaskFile: [8]u8,
};
type
  ATA_PASS_THROUGH_EX {.bycopy.} = object
    Length: uint16
    AtaFlags: uint16
    PathId: uint8
    TargetId: uint8
    Lun: uint8
    ReservedAsUchar: uint8
    DataTransferLength: uint32
    TimeOutValue: uint32
    ReservedAsUlong: uint32
    DataBufferOffset: uint
    PreviousTaskFile: array[8, uint8]
    CurrentTaskFile: array[8, uint8]
struct ATA_PASS_THROUGH_EX
{
    ushort Length;
    ushort AtaFlags;
    ubyte PathId;
    ubyte TargetId;
    ubyte Lun;
    ubyte ReservedAsUchar;
    uint DataTransferLength;
    uint TimeOutValue;
    uint ReservedAsUlong;
    size_t DataBufferOffset;
    ubyte[8] PreviousTaskFile;
    ubyte[8] CurrentTaskFile;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ATA_PASS_THROUGH_EX サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Length : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; AtaFlags : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; PathId : BYTE (+4, 1byte)  poke st,4,値  /  値 = peek(st,4)
; TargetId : BYTE (+5, 1byte)  poke st,5,値  /  値 = peek(st,5)
; Lun : BYTE (+6, 1byte)  poke st,6,値  /  値 = peek(st,6)
; ReservedAsUchar : BYTE (+7, 1byte)  poke st,7,値  /  値 = peek(st,7)
; DataTransferLength : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; TimeOutValue : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ReservedAsUlong : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DataBufferOffset : UINT_PTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; PreviousTaskFile : BYTE (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; CurrentTaskFile : BYTE (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ATA_PASS_THROUGH_EX サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Length : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; AtaFlags : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; PathId : BYTE (+4, 1byte)  poke st,4,値  /  値 = peek(st,4)
; TargetId : BYTE (+5, 1byte)  poke st,5,値  /  値 = peek(st,5)
; Lun : BYTE (+6, 1byte)  poke st,6,値  /  値 = peek(st,6)
; ReservedAsUchar : BYTE (+7, 1byte)  poke st,7,値  /  値 = peek(st,7)
; DataTransferLength : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; TimeOutValue : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ReservedAsUlong : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DataBufferOffset : UINT_PTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; PreviousTaskFile : BYTE (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; CurrentTaskFile : BYTE (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ATA_PASS_THROUGH_EX
    #field short Length
    #field short AtaFlags
    #field byte PathId
    #field byte TargetId
    #field byte Lun
    #field byte ReservedAsUchar
    #field int DataTransferLength
    #field int TimeOutValue
    #field int ReservedAsUlong
    #field intptr DataBufferOffset
    #field byte PreviousTaskFile 8
    #field byte CurrentTaskFile 8
#endstruct

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