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

ATA_PASS_THROUGH_DIRECT

構造体
サイズ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)。
DataBuffervoid*8/4+24+20データを直接やり取りするバッファへのポインタ。
PreviousTaskFileBYTE8+32+2448ビットコマンド用の前タスクファイルレジスタ値(8バイト)。
CurrentTaskFileBYTE8+40+32ATAタスクファイルレジスタの現在値(8バイト)。

各言語での定義

#include <windows.h>

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

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ATA_PASS_THROUGH_DIRECT
{
    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 IntPtr DataBuffer;
    [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_DIRECT
    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 DataBuffer As IntPtr
    <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_DIRECT(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),
        ("DataBuffer", ctypes.c_void_p),
        ("PreviousTaskFile", ctypes.c_ubyte * 8),
        ("CurrentTaskFile", ctypes.c_ubyte * 8),
    ]
#[repr(C)]
pub struct ATA_PASS_THROUGH_DIRECT {
    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 DataBuffer: *mut core::ffi::c_void,
    pub PreviousTaskFile: [u8; 8],
    pub CurrentTaskFile: [u8; 8],
}
import "golang.org/x/sys/windows"

type ATA_PASS_THROUGH_DIRECT struct {
	Length uint16
	AtaFlags uint16
	PathId byte
	TargetId byte
	Lun byte
	ReservedAsUchar byte
	DataTransferLength uint32
	TimeOutValue uint32
	ReservedAsUlong uint32
	DataBuffer uintptr
	PreviousTaskFile [8]byte
	CurrentTaskFile [8]byte
}
type
  ATA_PASS_THROUGH_DIRECT = record
    Length: Word;
    AtaFlags: Word;
    PathId: Byte;
    TargetId: Byte;
    Lun: Byte;
    ReservedAsUchar: Byte;
    DataTransferLength: DWORD;
    TimeOutValue: DWORD;
    ReservedAsUlong: DWORD;
    DataBuffer: Pointer;
    PreviousTaskFile: array[0..7] of Byte;
    CurrentTaskFile: array[0..7] of Byte;
  end;
const ATA_PASS_THROUGH_DIRECT = extern struct {
    Length: u16,
    AtaFlags: u16,
    PathId: u8,
    TargetId: u8,
    Lun: u8,
    ReservedAsUchar: u8,
    DataTransferLength: u32,
    TimeOutValue: u32,
    ReservedAsUlong: u32,
    DataBuffer: ?*anyopaque,
    PreviousTaskFile: [8]u8,
    CurrentTaskFile: [8]u8,
};
type
  ATA_PASS_THROUGH_DIRECT {.bycopy.} = object
    Length: uint16
    AtaFlags: uint16
    PathId: uint8
    TargetId: uint8
    Lun: uint8
    ReservedAsUchar: uint8
    DataTransferLength: uint32
    TimeOutValue: uint32
    ReservedAsUlong: uint32
    DataBuffer: pointer
    PreviousTaskFile: array[8, uint8]
    CurrentTaskFile: array[8, uint8]
struct ATA_PASS_THROUGH_DIRECT
{
    ushort Length;
    ushort AtaFlags;
    ubyte PathId;
    ubyte TargetId;
    ubyte Lun;
    ubyte ReservedAsUchar;
    uint DataTransferLength;
    uint TimeOutValue;
    uint ReservedAsUlong;
    void* DataBuffer;
    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_DIRECT サイズ: 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 も可)
; DataBuffer : void* (+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_DIRECT サイズ: 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 も可)
; DataBuffer : void* (+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_DIRECT
    #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 DataBuffer
    #field byte PreviousTaskFile 8
    #field byte CurrentTaskFile 8
#endstruct

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