Win32 API 日本語リファレンス
ホーム › AI.MachineLearning.DirectML › DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC

DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 48 バイト / x86: 32 バイト

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

フィールド

フィールド型サイズx64x86説明
InputTensorDML_TENSOR_DESC*8/4+0+0クリップ順方向の入力値を保持する入力テンソルへのポインタ。
InputGradientTensorDML_TENSOR_DESC*8/4+8+4上流から逆伝播してきた勾配を保持する入力テンソルへのポインタ。
OutputGradientTensorDML_TENSOR_DESC*8/4+16+8クリップ範囲内の要素のみ勾配を通した結果を格納する出力テンソルへのポインタ。
MinMaxDataTypeDML_TENSOR_DATA_TYPE4+24+12MinおよびMaxの値を解釈するデータ型を指定する列挙値。
MinDML_SCALAR_UNION8+32+16クリップ下限値を表す共用体。MinMaxDataTypeに従って解釈する。
MaxDML_SCALAR_UNION8+40+24クリップ上限値を表す共用体。MinMaxDataTypeに従って解釈する。

各言語での定義

#include <windows.h>

// DML_SCALAR_UNION  (x64 8 / x86 8 バイト)
typedef struct DML_SCALAR_UNION {
    BYTE Bytes[8];
    CHAR Int8;
    BYTE UInt8;
    SHORT Int16;
    WORD UInt16;
    INT Int32;
    DWORD UInt32;
    LONGLONG Int64;
    ULONGLONG UInt64;
    FLOAT Float32;
    DOUBLE Float64;
} DML_SCALAR_UNION;

// DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC  (x64 48 / x86 32 バイト)
typedef struct DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC {
    DML_TENSOR_DESC* InputTensor;
    DML_TENSOR_DESC* InputGradientTensor;
    DML_TENSOR_DESC* OutputGradientTensor;
    DML_TENSOR_DATA_TYPE MinMaxDataType;
    DML_SCALAR_UNION Min;
    DML_SCALAR_UNION Max;
} DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_SCALAR_UNION
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public byte[] Bytes;
    public sbyte Int8;
    public byte UInt8;
    public short Int16;
    public ushort UInt16;
    public int Int32;
    public uint UInt32;
    public long Int64;
    public ulong UInt64;
    public float Float32;
    public double Float64;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC
{
    public IntPtr InputTensor;
    public IntPtr InputGradientTensor;
    public IntPtr OutputGradientTensor;
    public int MinMaxDataType;
    public DML_SCALAR_UNION Min;
    public DML_SCALAR_UNION Max;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_SCALAR_UNION
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public Bytes() As Byte
    Public Int8 As SByte
    Public UInt8 As Byte
    Public Int16 As Short
    Public UInt16 As UShort
    Public Int32 As Integer
    Public UInt32 As UInteger
    Public Int64 As Long
    Public UInt64 As ULong
    Public Float32 As Single
    Public Float64 As Double
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC
    Public InputTensor As IntPtr
    Public InputGradientTensor As IntPtr
    Public OutputGradientTensor As IntPtr
    Public MinMaxDataType As Integer
    Public Min As DML_SCALAR_UNION
    Public Max As DML_SCALAR_UNION
End Structure
import ctypes
from ctypes import wintypes

class DML_SCALAR_UNION(ctypes.Structure):
    _fields_ = [
        ("Bytes", ctypes.c_ubyte * 8),
        ("Int8", ctypes.c_byte),
        ("UInt8", ctypes.c_ubyte),
        ("Int16", ctypes.c_short),
        ("UInt16", ctypes.c_ushort),
        ("Int32", ctypes.c_int),
        ("UInt32", wintypes.DWORD),
        ("Int64", ctypes.c_longlong),
        ("UInt64", ctypes.c_ulonglong),
        ("Float32", ctypes.c_float),
        ("Float64", ctypes.c_double),
    ]

class DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC(ctypes.Structure):
    _fields_ = [
        ("InputTensor", ctypes.c_void_p),
        ("InputGradientTensor", ctypes.c_void_p),
        ("OutputGradientTensor", ctypes.c_void_p),
        ("MinMaxDataType", ctypes.c_int),
        ("Min", DML_SCALAR_UNION),
        ("Max", DML_SCALAR_UNION),
    ]
#[repr(C)]
pub struct DML_SCALAR_UNION {
    pub Bytes: [u8; 8],
    pub Int8: i8,
    pub UInt8: u8,
    pub Int16: i16,
    pub UInt16: u16,
    pub Int32: i32,
    pub UInt32: u32,
    pub Int64: i64,
    pub UInt64: u64,
    pub Float32: f32,
    pub Float64: f64,
}

#[repr(C)]
pub struct DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC {
    pub InputTensor: *mut core::ffi::c_void,
    pub InputGradientTensor: *mut core::ffi::c_void,
    pub OutputGradientTensor: *mut core::ffi::c_void,
    pub MinMaxDataType: i32,
    pub Min: DML_SCALAR_UNION,
    pub Max: DML_SCALAR_UNION,
}
import "golang.org/x/sys/windows"

type DML_SCALAR_UNION struct {
	Bytes [8]byte
	Int8 int8
	UInt8 byte
	Int16 int16
	UInt16 uint16
	Int32 int32
	UInt32 uint32
	Int64 int64
	UInt64 uint64
	Float32 float32
	Float64 float64
}

type DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC struct {
	InputTensor uintptr
	InputGradientTensor uintptr
	OutputGradientTensor uintptr
	MinMaxDataType int32
	Min DML_SCALAR_UNION
	Max DML_SCALAR_UNION
}
type
  DML_SCALAR_UNION = record
    Bytes: array[0..7] of Byte;
    Int8: Shortint;
    UInt8: Byte;
    Int16: Smallint;
    UInt16: Word;
    Int32: Integer;
    UInt32: DWORD;
    Int64: Int64;
    UInt64: UInt64;
    Float32: Single;
    Float64: Double;
  end;

  DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC = record
    InputTensor: Pointer;
    InputGradientTensor: Pointer;
    OutputGradientTensor: Pointer;
    MinMaxDataType: Integer;
    Min: DML_SCALAR_UNION;
    Max: DML_SCALAR_UNION;
  end;
const DML_SCALAR_UNION = extern struct {
    Bytes: [8]u8,
    Int8: i8,
    UInt8: u8,
    Int16: i16,
    UInt16: u16,
    Int32: i32,
    UInt32: u32,
    Int64: i64,
    UInt64: u64,
    Float32: f32,
    Float64: f64,
};

const DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC = extern struct {
    InputTensor: ?*anyopaque,
    InputGradientTensor: ?*anyopaque,
    OutputGradientTensor: ?*anyopaque,
    MinMaxDataType: i32,
    Min: DML_SCALAR_UNION,
    Max: DML_SCALAR_UNION,
};
type
  DML_SCALAR_UNION {.bycopy.} = object
    Bytes: array[8, uint8]
    Int8: int8
    UInt8: uint8
    Int16: int16
    UInt16: uint16
    Int32: int32
    UInt32: uint32
    Int64: int64
    UInt64: uint64
    Float32: float32
    Float64: float64

  DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC {.bycopy.} = object
    InputTensor: pointer
    InputGradientTensor: pointer
    OutputGradientTensor: pointer
    MinMaxDataType: int32
    Min: DML_SCALAR_UNION
    Max: DML_SCALAR_UNION
struct DML_SCALAR_UNION
{
    ubyte[8] Bytes;
    byte Int8;
    ubyte UInt8;
    short Int16;
    ushort UInt16;
    int Int32;
    uint UInt32;
    long Int64;
    ulong UInt64;
    float Float32;
    double Float64;
}

struct DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC
{
    void* InputTensor;
    void* InputGradientTensor;
    void* OutputGradientTensor;
    int MinMaxDataType;
    DML_SCALAR_UNION Min;
    DML_SCALAR_UNION Max;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; InputGradientTensor : DML_TENSOR_DESC* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; OutputGradientTensor : DML_TENSOR_DESC* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; MinMaxDataType : DML_TENSOR_DATA_TYPE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Min : DML_SCALAR_UNION (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; Max : DML_SCALAR_UNION (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; InputGradientTensor : DML_TENSOR_DESC* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; OutputGradientTensor : DML_TENSOR_DESC* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; MinMaxDataType : DML_TENSOR_DATA_TYPE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Min : DML_SCALAR_UNION (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; Max : DML_SCALAR_UNION (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC
    #field intptr InputTensor
    #field intptr InputGradientTensor
    #field intptr OutputGradientTensor
    #field int MinMaxDataType
    #field byte Min 8
    #field byte Max 8
#endstruct

stdim st, DML_ELEMENT_WISE_CLIP_GRAD1_OPERATOR_DESC        ; NSTRUCT 変数を確保
st->MinMaxDataType = 100
mes "MinMaxDataType=" + st->MinMaxDataType
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。