DEVICE_MANAGE_DATA_SET_ATTRIBUTES
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Size | DWORD | 4 | +0 | +0 | このデータ構造体のサイズです。
sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) に設定しなければなりません。 | ||||||||||||||||||
| Action | DWORD | 4 | +4 | +4 |
| ||||||||||||||||||
| Flags | DWORD | 4 | +8 | +8 | 各操作に対するフラグです。
| ||||||||||||||||||
| ParameterBlockOffset | DWORD | 4 | +12 | +12 | この構造体に連続するバッファーに格納されたパラメーターブロックの先頭までのバイトオフセットです。対応する構造体のアラインメントに合わせて配置しなければなりません。値が 0 の場合はパラメーターブロックが存在しないことを示し、 ParameterBlockLength メンバーも 0 でなければなりません。 | ||||||||||||||||||
| ParameterBlockLength | DWORD | 4 | +16 | +16 | パラメーターブロックの長さ (バイト単位) です。値が 0 の場合はパラメーターブロックが存在しないことを示し、 ParameterBlockOffset メンバーも 0 でなければなりません。 | ||||||||||||||||||
| DataSetRangesOffset | DWORD | 4 | +20 | +20 | この構造体に連続するバッファーに格納された、 DEVICE_DATA_SET_RANGE 構造体の配列から成るデータセット範囲ブロックの先頭までのバイトオフセットです。 DEVICE_DATA_SET_RANGE 構造体のアラインメントに合わせて配置しなければなりません。値が 0 の場合はデータセット範囲ブロックが存在しないことを示し、 DataSetRangesLength メンバーも 0 でなければなりません。 | ||||||||||||||||||
| DataSetRangesLength | DWORD | 4 | +24 | +24 | データセット範囲ブロックの長さ (バイト単位) です。値が 0 の場合はデータセット範囲ブロックが存在しないことを示し、 DataSetRangesOffset メンバーも 0 でなければなりません。 |
公式ドキュメント
<a href="/windows/desktop/api/winioctl/ni-winioctl-ioctl_storage_manage_data_set_attributes">IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES</a>
制御コードの入力構造体です。
解説(Remarks)
この構造体を含むバッファーの全長は、少なくとも
(sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) + ParameterBlockLength + DataSetRangesLength) でなければなりません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DEVICE_MANAGE_DATA_SET_ATTRIBUTES (x64 28 / x86 28 バイト)
typedef struct DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
DWORD Size;
DWORD Action;
DWORD Flags;
DWORD ParameterBlockOffset;
DWORD ParameterBlockLength;
DWORD DataSetRangesOffset;
DWORD DataSetRangesLength;
} DEVICE_MANAGE_DATA_SET_ATTRIBUTES;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DEVICE_MANAGE_DATA_SET_ATTRIBUTES
{
public uint Size;
public uint Action;
public uint Flags;
public uint ParameterBlockOffset;
public uint ParameterBlockLength;
public uint DataSetRangesOffset;
public uint DataSetRangesLength;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DEVICE_MANAGE_DATA_SET_ATTRIBUTES
Public Size As UInteger
Public Action As UInteger
Public Flags As UInteger
Public ParameterBlockOffset As UInteger
Public ParameterBlockLength As UInteger
Public DataSetRangesOffset As UInteger
Public DataSetRangesLength As UInteger
End Structureimport ctypes
from ctypes import wintypes
class DEVICE_MANAGE_DATA_SET_ATTRIBUTES(ctypes.Structure):
_fields_ = [
("Size", wintypes.DWORD),
("Action", wintypes.DWORD),
("Flags", wintypes.DWORD),
("ParameterBlockOffset", wintypes.DWORD),
("ParameterBlockLength", wintypes.DWORD),
("DataSetRangesOffset", wintypes.DWORD),
("DataSetRangesLength", wintypes.DWORD),
]#[repr(C)]
pub struct DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
pub Size: u32,
pub Action: u32,
pub Flags: u32,
pub ParameterBlockOffset: u32,
pub ParameterBlockLength: u32,
pub DataSetRangesOffset: u32,
pub DataSetRangesLength: u32,
}import "golang.org/x/sys/windows"
type DEVICE_MANAGE_DATA_SET_ATTRIBUTES struct {
Size uint32
Action uint32
Flags uint32
ParameterBlockOffset uint32
ParameterBlockLength uint32
DataSetRangesOffset uint32
DataSetRangesLength uint32
}type
DEVICE_MANAGE_DATA_SET_ATTRIBUTES = record
Size: DWORD;
Action: DWORD;
Flags: DWORD;
ParameterBlockOffset: DWORD;
ParameterBlockLength: DWORD;
DataSetRangesOffset: DWORD;
DataSetRangesLength: DWORD;
end;const DEVICE_MANAGE_DATA_SET_ATTRIBUTES = extern struct {
Size: u32,
Action: u32,
Flags: u32,
ParameterBlockOffset: u32,
ParameterBlockLength: u32,
DataSetRangesOffset: u32,
DataSetRangesLength: u32,
};type
DEVICE_MANAGE_DATA_SET_ATTRIBUTES {.bycopy.} = object
Size: uint32
Action: uint32
Flags: uint32
ParameterBlockOffset: uint32
ParameterBlockLength: uint32
DataSetRangesOffset: uint32
DataSetRangesLength: uint32struct DEVICE_MANAGE_DATA_SET_ATTRIBUTES
{
uint Size;
uint Action;
uint Flags;
uint ParameterBlockOffset;
uint ParameterBlockLength;
uint DataSetRangesOffset;
uint DataSetRangesLength;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DEVICE_MANAGE_DATA_SET_ATTRIBUTES サイズ: 28 バイト(x64)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; Size : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Action : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Flags : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ParameterBlockOffset : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ParameterBlockLength : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; DataSetRangesOffset : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; DataSetRangesLength : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DEVICE_MANAGE_DATA_SET_ATTRIBUTES
#field int Size
#field int Action
#field int Flags
#field int ParameterBlockOffset
#field int ParameterBlockLength
#field int DataSetRangesOffset
#field int DataSetRangesLength
#endstruct
stdim st, DEVICE_MANAGE_DATA_SET_ATTRIBUTES ; NSTRUCT 変数を確保
st->Size = 100
mes "Size=" + st->Size