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

DSM_NOTIFICATION_REQUEST_BLOCK

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

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

フィールド

フィールド型サイズx64x86説明
SizeDWORD4+0+0この要求ブロックのバイトサイズ。
VersionDWORD4+4+4この構造体のバージョン番号。
NotifyFlagsDWORD4+8+8通知の動作フラグ。
DataSetProfileDWORD4+12+12データセットのプロファイル種別(用途ヒント)。
ReservedDWORD12+16+16予約フィールド。0を設定する。
DataSetRangesCountDWORD4+28+28DataSetRanges配列の要素数。
DataSetRangesMP_DEVICE_DATA_SET_RANGE16+32+32対象範囲を表すMP_DEVICE_DATA_SET_RANGE可変長配列。

各言語での定義

#include <windows.h>

// MP_DEVICE_DATA_SET_RANGE  (x64 16 / x86 16 バイト)
typedef struct MP_DEVICE_DATA_SET_RANGE {
    LONGLONG StartingOffset;
    ULONGLONG LengthInBytes;
} MP_DEVICE_DATA_SET_RANGE;

// DSM_NOTIFICATION_REQUEST_BLOCK  (x64 48 / x86 48 バイト)
typedef struct DSM_NOTIFICATION_REQUEST_BLOCK {
    DWORD Size;
    DWORD Version;
    DWORD NotifyFlags;
    DWORD DataSetProfile;
    DWORD Reserved[3];
    DWORD DataSetRangesCount;
    MP_DEVICE_DATA_SET_RANGE DataSetRanges[1];
} DSM_NOTIFICATION_REQUEST_BLOCK;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MP_DEVICE_DATA_SET_RANGE
{
    public long StartingOffset;
    public ulong LengthInBytes;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSM_NOTIFICATION_REQUEST_BLOCK
{
    public uint Size;
    public uint Version;
    public uint NotifyFlags;
    public uint DataSetProfile;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public uint[] Reserved;
    public uint DataSetRangesCount;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public MP_DEVICE_DATA_SET_RANGE[] DataSetRanges;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MP_DEVICE_DATA_SET_RANGE
    Public StartingOffset As Long
    Public LengthInBytes As ULong
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSM_NOTIFICATION_REQUEST_BLOCK
    Public Size As UInteger
    Public Version As UInteger
    Public NotifyFlags As UInteger
    Public DataSetProfile As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public Reserved() As UInteger
    Public DataSetRangesCount As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public DataSetRanges() As MP_DEVICE_DATA_SET_RANGE
End Structure
import ctypes
from ctypes import wintypes

class MP_DEVICE_DATA_SET_RANGE(ctypes.Structure):
    _fields_ = [
        ("StartingOffset", ctypes.c_longlong),
        ("LengthInBytes", ctypes.c_ulonglong),
    ]

class DSM_NOTIFICATION_REQUEST_BLOCK(ctypes.Structure):
    _fields_ = [
        ("Size", wintypes.DWORD),
        ("Version", wintypes.DWORD),
        ("NotifyFlags", wintypes.DWORD),
        ("DataSetProfile", wintypes.DWORD),
        ("Reserved", wintypes.DWORD * 3),
        ("DataSetRangesCount", wintypes.DWORD),
        ("DataSetRanges", MP_DEVICE_DATA_SET_RANGE * 1),
    ]
#[repr(C)]
pub struct MP_DEVICE_DATA_SET_RANGE {
    pub StartingOffset: i64,
    pub LengthInBytes: u64,
}

#[repr(C)]
pub struct DSM_NOTIFICATION_REQUEST_BLOCK {
    pub Size: u32,
    pub Version: u32,
    pub NotifyFlags: u32,
    pub DataSetProfile: u32,
    pub Reserved: [u32; 3],
    pub DataSetRangesCount: u32,
    pub DataSetRanges: [MP_DEVICE_DATA_SET_RANGE; 1],
}
import "golang.org/x/sys/windows"

type MP_DEVICE_DATA_SET_RANGE struct {
	StartingOffset int64
	LengthInBytes uint64
}

type DSM_NOTIFICATION_REQUEST_BLOCK struct {
	Size uint32
	Version uint32
	NotifyFlags uint32
	DataSetProfile uint32
	Reserved [3]uint32
	DataSetRangesCount uint32
	DataSetRanges [1]MP_DEVICE_DATA_SET_RANGE
}
type
  MP_DEVICE_DATA_SET_RANGE = record
    StartingOffset: Int64;
    LengthInBytes: UInt64;
  end;

  DSM_NOTIFICATION_REQUEST_BLOCK = record
    Size: DWORD;
    Version: DWORD;
    NotifyFlags: DWORD;
    DataSetProfile: DWORD;
    Reserved: array[0..2] of DWORD;
    DataSetRangesCount: DWORD;
    DataSetRanges: array[0..0] of MP_DEVICE_DATA_SET_RANGE;
  end;
const MP_DEVICE_DATA_SET_RANGE = extern struct {
    StartingOffset: i64,
    LengthInBytes: u64,
};

const DSM_NOTIFICATION_REQUEST_BLOCK = extern struct {
    Size: u32,
    Version: u32,
    NotifyFlags: u32,
    DataSetProfile: u32,
    Reserved: [3]u32,
    DataSetRangesCount: u32,
    DataSetRanges: [1]MP_DEVICE_DATA_SET_RANGE,
};
type
  MP_DEVICE_DATA_SET_RANGE {.bycopy.} = object
    StartingOffset: int64
    LengthInBytes: uint64

  DSM_NOTIFICATION_REQUEST_BLOCK {.bycopy.} = object
    Size: uint32
    Version: uint32
    NotifyFlags: uint32
    DataSetProfile: uint32
    Reserved: array[3, uint32]
    DataSetRangesCount: uint32
    DataSetRanges: array[1, MP_DEVICE_DATA_SET_RANGE]
struct MP_DEVICE_DATA_SET_RANGE
{
    long StartingOffset;
    ulong LengthInBytes;
}

struct DSM_NOTIFICATION_REQUEST_BLOCK
{
    uint Size;
    uint Version;
    uint NotifyFlags;
    uint DataSetProfile;
    uint[3] Reserved;
    uint DataSetRangesCount;
    MP_DEVICE_DATA_SET_RANGE[1] DataSetRanges;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DSM_NOTIFICATION_REQUEST_BLOCK サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Size : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Version : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; NotifyFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DataSetProfile : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Reserved : DWORD (+16, 12byte)  varptr(st)+16 を基点に操作(12byte:入れ子/配列)
; DataSetRangesCount : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; DataSetRanges : MP_DEVICE_DATA_SET_RANGE (+32, 16byte)  varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global MP_DEVICE_DATA_SET_RANGE
    #field int64 StartingOffset
    #field int64 LengthInBytes
#endstruct

#defstruct global DSM_NOTIFICATION_REQUEST_BLOCK
    #field int Size
    #field int Version
    #field int NotifyFlags
    #field int DataSetProfile
    #field int Reserved 3
    #field int DataSetRangesCount
    #field MP_DEVICE_DATA_SET_RANGE DataSetRanges 1
#endstruct

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