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

DML_VALUE_SCALE_2D_OPERATOR_DESC

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

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

フィールド

フィールドサイズx64x86説明
InputTensorDML_TENSOR_DESC*8/4+0+0入力データを格納するテンソルです。このテンソルの次元は { BatchCount, ChannelCount, Height, Width } でなければなりません。
OutputTensorDML_TENSOR_DESC*8/4+8+4結果の書き込み先となるテンソルです。このテンソルの次元は InputTensor の次元と一致していなければなりません。
ScaleFLOAT4+16+8すべての入力値に適用されるスケール値です。
ChannelCountDWORD4+20+12このフィールドは Bias 配列のサイズを決定します。このフィールドは 1 または 3 のいずれかに設定する必要があり、また入力テンソルの Channel 次元のサイズと一致していなければなりません。
BiasFLOAT*8/4+24+16入力テンソルの各次元に対するバイアス項を格納する FLOAT 値の配列です。

公式ドキュメント

要素ごとのスケールとバイアスの関数 Output = Scale * Input + Bias を実行します。この演算子は、スケールとバイアスを指定した DML_ELEMENT_WISE_IDENTITY_OPERATOR_DESC の使用に似ていますが、DML_VALUE_SCALE_2D_OPERATOR_DESC はテンソル全体に単一のバイアスを適用するのではなく、チャネルごとに異なるバイアスを適用します。

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

各言語での定義

#include <windows.h>

// DML_VALUE_SCALE_2D_OPERATOR_DESC  (x64 32 / x86 20 バイト)
typedef struct DML_VALUE_SCALE_2D_OPERATOR_DESC {
    DML_TENSOR_DESC* InputTensor;
    DML_TENSOR_DESC* OutputTensor;
    FLOAT Scale;
    DWORD ChannelCount;
    FLOAT* Bias;
} DML_VALUE_SCALE_2D_OPERATOR_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_VALUE_SCALE_2D_OPERATOR_DESC
{
    public IntPtr InputTensor;
    public IntPtr OutputTensor;
    public float Scale;
    public uint ChannelCount;
    public IntPtr Bias;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_VALUE_SCALE_2D_OPERATOR_DESC
    Public InputTensor As IntPtr
    Public OutputTensor As IntPtr
    Public Scale As Single
    Public ChannelCount As UInteger
    Public Bias As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DML_VALUE_SCALE_2D_OPERATOR_DESC(ctypes.Structure):
    _fields_ = [
        ("InputTensor", ctypes.c_void_p),
        ("OutputTensor", ctypes.c_void_p),
        ("Scale", ctypes.c_float),
        ("ChannelCount", wintypes.DWORD),
        ("Bias", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DML_VALUE_SCALE_2D_OPERATOR_DESC {
    pub InputTensor: *mut core::ffi::c_void,
    pub OutputTensor: *mut core::ffi::c_void,
    pub Scale: f32,
    pub ChannelCount: u32,
    pub Bias: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DML_VALUE_SCALE_2D_OPERATOR_DESC struct {
	InputTensor uintptr
	OutputTensor uintptr
	Scale float32
	ChannelCount uint32
	Bias uintptr
}
type
  DML_VALUE_SCALE_2D_OPERATOR_DESC = record
    InputTensor: Pointer;
    OutputTensor: Pointer;
    Scale: Single;
    ChannelCount: DWORD;
    Bias: Pointer;
  end;
const DML_VALUE_SCALE_2D_OPERATOR_DESC = extern struct {
    InputTensor: ?*anyopaque,
    OutputTensor: ?*anyopaque,
    Scale: f32,
    ChannelCount: u32,
    Bias: ?*anyopaque,
};
type
  DML_VALUE_SCALE_2D_OPERATOR_DESC {.bycopy.} = object
    InputTensor: pointer
    OutputTensor: pointer
    Scale: float32
    ChannelCount: uint32
    Bias: pointer
struct DML_VALUE_SCALE_2D_OPERATOR_DESC
{
    void* InputTensor;
    void* OutputTensor;
    float Scale;
    uint ChannelCount;
    void* Bias;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DML_VALUE_SCALE_2D_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:入れ子/配列)
; Scale : FLOAT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ChannelCount : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Bias : FLOAT* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DML_VALUE_SCALE_2D_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:入れ子/配列)
; Scale : FLOAT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ChannelCount : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Bias : FLOAT* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DML_VALUE_SCALE_2D_OPERATOR_DESC
    #field intptr InputTensor
    #field intptr OutputTensor
    #field float Scale
    #field int ChannelCount
    #field intptr Bias
#endstruct

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