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

DML_ELEMENT_WISE_CLIP_OPERATOR_DESC

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

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

フィールド

フィールド型サイズx64x86説明
InputTensorDML_TENSOR_DESC*8/4+0+0読み取り元の入力テンソルです。
OutputTensorDML_TENSOR_DESC*8/4+8+4結果の書き込み先となる出力テンソルです。
ScaleBiasDML_SCALE_BIAS*8/4+16+8入力に適用する省略可能なスケールとバイアスです。指定した場合、この演算子を計算する前に、各 入力 要素に関数 g(x) = x * scale + bias を適用する効果があります。
MinFLOAT4+24+12最小値です。この値を下回る要素は、演算子によって Min に置き換えられます。
MaxFLOAT4+28+16最大値です。この値を上回る要素は、演算子によって Max に置き換えられます。

公式ドキュメント

InputTensor の各要素に対して次の演算を実行し、その結果を OutputTensor の対応する要素に格納します。この演算子は、入力のすべての要素を閉区間 [Min, Max] 内にクランプ (制限) します。

f(x) = max(Min, min(x, Max))

ここで max(a,b) は 2 つの値のうち大きい方を返し、min(a,b) は 2 つの値 a,b のうち小さい方を返します。

この演算子はインプレース実行をサポートします。つまり、バインド時に OutputTensor が InputTensor をエイリアスすることが許可されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// DML_ELEMENT_WISE_CLIP_OPERATOR_DESC  (x64 32 / x86 20 バイト)
typedef struct DML_ELEMENT_WISE_CLIP_OPERATOR_DESC {
    DML_TENSOR_DESC* InputTensor;
    DML_TENSOR_DESC* OutputTensor;
    DML_SCALE_BIAS* ScaleBias;
    FLOAT Min;
    FLOAT Max;
} DML_ELEMENT_WISE_CLIP_OPERATOR_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_ELEMENT_WISE_CLIP_OPERATOR_DESC
{
    public IntPtr InputTensor;
    public IntPtr OutputTensor;
    public IntPtr ScaleBias;
    public float Min;
    public float Max;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_ELEMENT_WISE_CLIP_OPERATOR_DESC
    Public InputTensor As IntPtr
    Public OutputTensor As IntPtr
    Public ScaleBias As IntPtr
    Public Min As Single
    Public Max As Single
End Structure
import ctypes
from ctypes import wintypes

class DML_ELEMENT_WISE_CLIP_OPERATOR_DESC(ctypes.Structure):
    _fields_ = [
        ("InputTensor", ctypes.c_void_p),
        ("OutputTensor", ctypes.c_void_p),
        ("ScaleBias", ctypes.c_void_p),
        ("Min", ctypes.c_float),
        ("Max", ctypes.c_float),
    ]
#[repr(C)]
pub struct DML_ELEMENT_WISE_CLIP_OPERATOR_DESC {
    pub InputTensor: *mut core::ffi::c_void,
    pub OutputTensor: *mut core::ffi::c_void,
    pub ScaleBias: *mut core::ffi::c_void,
    pub Min: f32,
    pub Max: f32,
}
import "golang.org/x/sys/windows"

type DML_ELEMENT_WISE_CLIP_OPERATOR_DESC struct {
	InputTensor uintptr
	OutputTensor uintptr
	ScaleBias uintptr
	Min float32
	Max float32
}
type
  DML_ELEMENT_WISE_CLIP_OPERATOR_DESC = record
    InputTensor: Pointer;
    OutputTensor: Pointer;
    ScaleBias: Pointer;
    Min: Single;
    Max: Single;
  end;
const DML_ELEMENT_WISE_CLIP_OPERATOR_DESC = extern struct {
    InputTensor: ?*anyopaque,
    OutputTensor: ?*anyopaque,
    ScaleBias: ?*anyopaque,
    Min: f32,
    Max: f32,
};
type
  DML_ELEMENT_WISE_CLIP_OPERATOR_DESC {.bycopy.} = object
    InputTensor: pointer
    OutputTensor: pointer
    ScaleBias: pointer
    Min: float32
    Max: float32
struct DML_ELEMENT_WISE_CLIP_OPERATOR_DESC
{
    void* InputTensor;
    void* OutputTensor;
    void* ScaleBias;
    float Min;
    float 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_OPERATOR_DESC サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; OutputTensor : DML_TENSOR_DESC* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ScaleBias : DML_SCALE_BIAS* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; Min : FLOAT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Max : FLOAT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DML_ELEMENT_WISE_CLIP_OPERATOR_DESC サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; OutputTensor : DML_TENSOR_DESC* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; ScaleBias : DML_SCALE_BIAS* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; Min : FLOAT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Max : FLOAT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DML_ELEMENT_WISE_CLIP_OPERATOR_DESC
    #field intptr InputTensor
    #field intptr OutputTensor
    #field intptr ScaleBias
    #field float Min
    #field float Max
#endstruct

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