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

MPIO_PASS_THROUGH_PATH_DIRECT

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

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

フィールド

フィールドサイズx64x86説明
PassThroughSCSI_PASS_THROUGH_DIRECT56/44+0+0実行するSCSI_PASS_THROUGH_DIRECTコマンド構造体。
VersionDWORD4+56+44この構造体のバージョン番号。
LengthWORD2+60+48この構造体のバイト長。
FlagsBYTE1+62+50MPIOパススルーの動作フラグ。
PortNumberBYTE1+63+51対象のポート番号。
MpioPathIdULONGLONG8+64+56コマンドを送る対象MPIOパスの識別子。

各言語での定義

#include <windows.h>

// SCSI_PASS_THROUGH_DIRECT  (x64 56 / x86 44 バイト)
typedef struct SCSI_PASS_THROUGH_DIRECT {
    WORD Length;
    BYTE ScsiStatus;
    BYTE PathId;
    BYTE TargetId;
    BYTE Lun;
    BYTE CdbLength;
    BYTE SenseInfoLength;
    BYTE DataIn;
    DWORD DataTransferLength;
    DWORD TimeOutValue;
    void* DataBuffer;
    DWORD SenseInfoOffset;
    BYTE Cdb[16];
} SCSI_PASS_THROUGH_DIRECT;

// MPIO_PASS_THROUGH_PATH_DIRECT  (x64 72 / x86 64 バイト)
typedef struct MPIO_PASS_THROUGH_PATH_DIRECT {
    SCSI_PASS_THROUGH_DIRECT PassThrough;
    DWORD Version;
    WORD Length;
    BYTE Flags;
    BYTE PortNumber;
    ULONGLONG MpioPathId;
} MPIO_PASS_THROUGH_PATH_DIRECT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SCSI_PASS_THROUGH_DIRECT
{
    public ushort Length;
    public byte ScsiStatus;
    public byte PathId;
    public byte TargetId;
    public byte Lun;
    public byte CdbLength;
    public byte SenseInfoLength;
    public byte DataIn;
    public uint DataTransferLength;
    public uint TimeOutValue;
    public IntPtr DataBuffer;
    public uint SenseInfoOffset;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] Cdb;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MPIO_PASS_THROUGH_PATH_DIRECT
{
    public SCSI_PASS_THROUGH_DIRECT PassThrough;
    public uint Version;
    public ushort Length;
    public byte Flags;
    public byte PortNumber;
    public ulong MpioPathId;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SCSI_PASS_THROUGH_DIRECT
    Public Length As UShort
    Public ScsiStatus As Byte
    Public PathId As Byte
    Public TargetId As Byte
    Public Lun As Byte
    Public CdbLength As Byte
    Public SenseInfoLength As Byte
    Public DataIn As Byte
    Public DataTransferLength As UInteger
    Public TimeOutValue As UInteger
    Public DataBuffer As IntPtr
    Public SenseInfoOffset As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public Cdb() As Byte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MPIO_PASS_THROUGH_PATH_DIRECT
    Public PassThrough As SCSI_PASS_THROUGH_DIRECT
    Public Version As UInteger
    Public Length As UShort
    Public Flags As Byte
    Public PortNumber As Byte
    Public MpioPathId As ULong
End Structure
import ctypes
from ctypes import wintypes

class SCSI_PASS_THROUGH_DIRECT(ctypes.Structure):
    _fields_ = [
        ("Length", ctypes.c_ushort),
        ("ScsiStatus", ctypes.c_ubyte),
        ("PathId", ctypes.c_ubyte),
        ("TargetId", ctypes.c_ubyte),
        ("Lun", ctypes.c_ubyte),
        ("CdbLength", ctypes.c_ubyte),
        ("SenseInfoLength", ctypes.c_ubyte),
        ("DataIn", ctypes.c_ubyte),
        ("DataTransferLength", wintypes.DWORD),
        ("TimeOutValue", wintypes.DWORD),
        ("DataBuffer", ctypes.c_void_p),
        ("SenseInfoOffset", wintypes.DWORD),
        ("Cdb", ctypes.c_ubyte * 16),
    ]

class MPIO_PASS_THROUGH_PATH_DIRECT(ctypes.Structure):
    _fields_ = [
        ("PassThrough", SCSI_PASS_THROUGH_DIRECT),
        ("Version", wintypes.DWORD),
        ("Length", ctypes.c_ushort),
        ("Flags", ctypes.c_ubyte),
        ("PortNumber", ctypes.c_ubyte),
        ("MpioPathId", ctypes.c_ulonglong),
    ]
#[repr(C)]
pub struct SCSI_PASS_THROUGH_DIRECT {
    pub Length: u16,
    pub ScsiStatus: u8,
    pub PathId: u8,
    pub TargetId: u8,
    pub Lun: u8,
    pub CdbLength: u8,
    pub SenseInfoLength: u8,
    pub DataIn: u8,
    pub DataTransferLength: u32,
    pub TimeOutValue: u32,
    pub DataBuffer: *mut core::ffi::c_void,
    pub SenseInfoOffset: u32,
    pub Cdb: [u8; 16],
}

#[repr(C)]
pub struct MPIO_PASS_THROUGH_PATH_DIRECT {
    pub PassThrough: SCSI_PASS_THROUGH_DIRECT,
    pub Version: u32,
    pub Length: u16,
    pub Flags: u8,
    pub PortNumber: u8,
    pub MpioPathId: u64,
}
import "golang.org/x/sys/windows"

type SCSI_PASS_THROUGH_DIRECT struct {
	Length uint16
	ScsiStatus byte
	PathId byte
	TargetId byte
	Lun byte
	CdbLength byte
	SenseInfoLength byte
	DataIn byte
	DataTransferLength uint32
	TimeOutValue uint32
	DataBuffer uintptr
	SenseInfoOffset uint32
	Cdb [16]byte
}

type MPIO_PASS_THROUGH_PATH_DIRECT struct {
	PassThrough SCSI_PASS_THROUGH_DIRECT
	Version uint32
	Length uint16
	Flags byte
	PortNumber byte
	MpioPathId uint64
}
type
  SCSI_PASS_THROUGH_DIRECT = record
    Length: Word;
    ScsiStatus: Byte;
    PathId: Byte;
    TargetId: Byte;
    Lun: Byte;
    CdbLength: Byte;
    SenseInfoLength: Byte;
    DataIn: Byte;
    DataTransferLength: DWORD;
    TimeOutValue: DWORD;
    DataBuffer: Pointer;
    SenseInfoOffset: DWORD;
    Cdb: array[0..15] of Byte;
  end;

  MPIO_PASS_THROUGH_PATH_DIRECT = record
    PassThrough: SCSI_PASS_THROUGH_DIRECT;
    Version: DWORD;
    Length: Word;
    Flags: Byte;
    PortNumber: Byte;
    MpioPathId: UInt64;
  end;
const SCSI_PASS_THROUGH_DIRECT = extern struct {
    Length: u16,
    ScsiStatus: u8,
    PathId: u8,
    TargetId: u8,
    Lun: u8,
    CdbLength: u8,
    SenseInfoLength: u8,
    DataIn: u8,
    DataTransferLength: u32,
    TimeOutValue: u32,
    DataBuffer: ?*anyopaque,
    SenseInfoOffset: u32,
    Cdb: [16]u8,
};

const MPIO_PASS_THROUGH_PATH_DIRECT = extern struct {
    PassThrough: SCSI_PASS_THROUGH_DIRECT,
    Version: u32,
    Length: u16,
    Flags: u8,
    PortNumber: u8,
    MpioPathId: u64,
};
type
  SCSI_PASS_THROUGH_DIRECT {.bycopy.} = object
    Length: uint16
    ScsiStatus: uint8
    PathId: uint8
    TargetId: uint8
    Lun: uint8
    CdbLength: uint8
    SenseInfoLength: uint8
    DataIn: uint8
    DataTransferLength: uint32
    TimeOutValue: uint32
    DataBuffer: pointer
    SenseInfoOffset: uint32
    Cdb: array[16, uint8]

  MPIO_PASS_THROUGH_PATH_DIRECT {.bycopy.} = object
    PassThrough: SCSI_PASS_THROUGH_DIRECT
    Version: uint32
    Length: uint16
    Flags: uint8
    PortNumber: uint8
    MpioPathId: uint64
struct SCSI_PASS_THROUGH_DIRECT
{
    ushort Length;
    ubyte ScsiStatus;
    ubyte PathId;
    ubyte TargetId;
    ubyte Lun;
    ubyte CdbLength;
    ubyte SenseInfoLength;
    ubyte DataIn;
    uint DataTransferLength;
    uint TimeOutValue;
    void* DataBuffer;
    uint SenseInfoOffset;
    ubyte[16] Cdb;
}

struct MPIO_PASS_THROUGH_PATH_DIRECT
{
    SCSI_PASS_THROUGH_DIRECT PassThrough;
    uint Version;
    ushort Length;
    ubyte Flags;
    ubyte PortNumber;
    ulong MpioPathId;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MPIO_PASS_THROUGH_PATH_DIRECT サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; PassThrough : SCSI_PASS_THROUGH_DIRECT (+0, 44byte)  varptr(st)+0 を基点に操作(44byte:入れ子/配列)
; Version : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; Length : WORD (+48, 2byte)  wpoke st,48,値  /  値 = wpeek(st,48)
; Flags : BYTE (+50, 1byte)  poke st,50,値  /  値 = peek(st,50)
; PortNumber : BYTE (+51, 1byte)  poke st,51,値  /  値 = peek(st,51)
; MpioPathId : ULONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MPIO_PASS_THROUGH_PATH_DIRECT サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; PassThrough : SCSI_PASS_THROUGH_DIRECT (+0, 56byte)  varptr(st)+0 を基点に操作(56byte:入れ子/配列)
; Version : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; Length : WORD (+60, 2byte)  wpoke st,60,値  /  値 = wpeek(st,60)
; Flags : BYTE (+62, 1byte)  poke st,62,値  /  値 = peek(st,62)
; PortNumber : BYTE (+63, 1byte)  poke st,63,値  /  値 = peek(st,63)
; MpioPathId : ULONGLONG (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SCSI_PASS_THROUGH_DIRECT
    #field short Length
    #field byte ScsiStatus
    #field byte PathId
    #field byte TargetId
    #field byte Lun
    #field byte CdbLength
    #field byte SenseInfoLength
    #field byte DataIn
    #field int DataTransferLength
    #field int TimeOutValue
    #field intptr DataBuffer
    #field int SenseInfoOffset
    #field byte Cdb 16
#endstruct

#defstruct global MPIO_PASS_THROUGH_PATH_DIRECT
    #field SCSI_PASS_THROUGH_DIRECT PassThrough
    #field int Version
    #field short Length
    #field byte Flags
    #field byte PortNumber
    #field int64 MpioPathId
#endstruct

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