Win32 API 日本語リファレンス
ホームSystem.Ioctl › DEVICE_MANAGE_DATA_SET_ATTRIBUTES

DEVICE_MANAGE_DATA_SET_ATTRIBUTES

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

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

フィールド

フィールドサイズx64x86説明
SizeDWORD4+0+0このデータ構造体のサイズです。 sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) に設定しなければなりません。
ActionDWORD4+4+4
  <a href="/windows/desktop/DevIO/device-data-management-set-action">DEVICE_DATA_MANAGEMENT_SET_ACTION</a> 型の有効な値です。
意味
DeviceDsmAction_Trim
1
トリム操作が実行されます。この値はユーザーモードアプリケーションではサポートされません。
DeviceDsmAction_Notification
2 | DeviceDsmActionFlag_NonDestructive (0x80000002)
通知操作が実行されます。追加のパラメーターは DEVICE_DSM_NOTIFICATION_PARAMETERS 構造体に格納されます。DeviceDsmActionFlag_NonDestructive (0x80000000) は、この操作が非破壊的であることをドライバースタックに示すためのビットフラグです。
DeviceDsmAction_OffloadRead
3 | DeviceDsmActionFlag_NonDestructive (0x80000003)
オフロード読み取り操作が実行されます。追加のパラメーターは DEVICE_DSM_OFFLOAD_READ_PARAMETERS 構造体に格納されます。DeviceDsmActionFlag_NonDestructive (0x80000000) は、この操作が非破壊的であることをドライバースタックに示すためのビットフラグです。

Windows 7 および Windows Server 2008 R2: この値は Windows 8 および Windows Server 2012 より前ではサポートされません。

DeviceDsmAction_OffloadWrite
4
オフロード書き込み操作が実行されます。追加のパラメーターは DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS 構造体に格納されます。

Windows 7 および Windows Server 2008 R2: この値は Windows 8 および Windows Server 2012 より前ではサポートされません。

DeviceDsmAction_Allocation
5 | DeviceDsmActionFlag_NonDestructive (0x80000005)
指定された最初のデータセット範囲について、割り当てビットマップが取得されます。 DeviceDsmActionFlag_NonDestructive (0x80000000) は、この操作が非破壊的であることをドライバースタックに示すためのビットフラグです。

Windows 7 および Windows Server 2008 R2: この値は Windows 8 および Windows Server 2012 より前ではサポートされません。

DeviceDsmAction_Repair
6 | DeviceDsmActionFlag_NonDestructive (0x80000006)
修復操作が実行されます。追加のパラメーターは DEVICE_DATA_SET_REPAIR_PARAMETERS 構造体に格納されます。DeviceDsmActionFlag_NonDestructive (0x80000000) は、この操作が非破壊的であることをドライバースタックに示すためのビットフラグです。

Windows 7 および Windows Server 2008 R2: この値は Windows 8 および Windows Server 2012 より前ではサポートされません。

DeviceDsmAction_Scrub
7 | DeviceDsmActionFlag_NonDestructive (0x80000007)
スクラブ操作が実行されます。DeviceDsmActionFlag_NonDestructive (0x80000000) は、この操作が非破壊的であることをドライバースタックに示すためのビットフラグです。

Windows 7 および Windows Server 2008 R2: この値は Windows 8 および Windows Server 2012 より前ではサポートされません。

DeviceDsmAction_Resiliency
8 | DeviceDsmActionFlag_NonDestructive (0x80000008)
回復性 (resiliency) 操作が実行されます。DeviceDsmActionFlag_NonDestructive (0x80000000) は、この操作が非破壊的であることをドライバースタックに示すためのビットフラグです。

Windows 7 および Windows Server 2008 R2: この値は Windows 8 および Windows Server 2012 より前ではサポートされません。

FlagsDWORD4+8+8

各操作に対するフラグです。

意味
DEVICE_DSM_FLAG_TRIM_NOT_FS_ALLOCATED
0x80000000
設定されている場合、記述された範囲はファイルシステムによって割り当てられていません。このフラグは DeviceDsmAction_Trim 操作に固有です。
DEVICE_DSM_FLAG_RESILIENCY_START_RESYNC
0x10000000
ストレージデバイス上で再同期操作を開始します。このフラグは DeviceDsmAction_Resiliency 操作に固有です。
DEVICE_DSM_FLAG_RESILIENCY_START_LOAD_BALANCING
0x20000000
ストレージデバイス上で負荷分散操作を開始します。このフラグは DeviceDsmAction_Resiliency 操作に固有です。
ParameterBlockOffsetDWORD4+12+12この構造体に連続するバッファーに格納されたパラメーターブロックの先頭までのバイトオフセットです。対応する構造体のアラインメントに合わせて配置しなければなりません。値が 0 の場合はパラメーターブロックが存在しないことを示し、 ParameterBlockLength メンバーも 0 でなければなりません。
ParameterBlockLengthDWORD4+16+16パラメーターブロックの長さ (バイト単位) です。値が 0 の場合はパラメーターブロックが存在しないことを示し、 ParameterBlockOffset メンバーも 0 でなければなりません。
DataSetRangesOffsetDWORD4+20+20この構造体に連続するバッファーに格納された、 DEVICE_DATA_SET_RANGE 構造体の配列から成るデータセット範囲ブロックの先頭までのバイトオフセットです。 DEVICE_DATA_SET_RANGE 構造体のアラインメントに合わせて配置しなければなりません。値が 0 の場合はデータセット範囲ブロックが存在しないことを示し、 DataSetRangesLength メンバーも 0 でなければなりません。
DataSetRangesLengthDWORD4+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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint32
struct 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