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

DML_BUFFER_TENSOR_DESC

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

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

フィールド

フィールド型サイズx64x86説明
DataTypeDML_TENSOR_DATA_TYPE4+0+0テンソル要素のデータ型を指定するDML_TENSOR_DATA_TYPE値(FLOAT32やUINT8等)。
FlagsDML_TENSOR_FLAGS4+4+4テンソルの属性を表すDML_TENSOR_FLAGSビットフラグ(定数化など)。
DimensionCountDWORD4+8+8テンソルの次元数。SizesおよびStrides配列の要素数を表す。
SizesDWORD*8/4+16+12各次元の論理サイズ(要素数)を並べたDWORD配列へのポインタ。
StridesDWORD*8/4+24+16各次元の物理ストライドを並べたDWORD配列へのポインタ。NULLで密充填を意味する。
TotalTensorSizeInBytesULONGLONG8+32+24テンソル全体が占めるバッファのバイト数。
GuaranteedBaseOffsetAlignmentDWORD4+40+32テンソル先頭オフセットが満たすことを保証するアライメント(バイト)。0で指定なし。

各言語での定義

#include <windows.h>

// DML_BUFFER_TENSOR_DESC  (x64 48 / x86 40 バイト)
typedef struct DML_BUFFER_TENSOR_DESC {
    DML_TENSOR_DATA_TYPE DataType;
    DML_TENSOR_FLAGS Flags;
    DWORD DimensionCount;
    DWORD* Sizes;
    DWORD* Strides;
    ULONGLONG TotalTensorSizeInBytes;
    DWORD GuaranteedBaseOffsetAlignment;
} DML_BUFFER_TENSOR_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_BUFFER_TENSOR_DESC
{
    public int DataType;
    public int Flags;
    public uint DimensionCount;
    public IntPtr Sizes;
    public IntPtr Strides;
    public ulong TotalTensorSizeInBytes;
    public uint GuaranteedBaseOffsetAlignment;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_BUFFER_TENSOR_DESC
    Public DataType As Integer
    Public Flags As Integer
    Public DimensionCount As UInteger
    Public Sizes As IntPtr
    Public Strides As IntPtr
    Public TotalTensorSizeInBytes As ULong
    Public GuaranteedBaseOffsetAlignment As UInteger
End Structure
import ctypes
from ctypes import wintypes

class DML_BUFFER_TENSOR_DESC(ctypes.Structure):
    _fields_ = [
        ("DataType", ctypes.c_int),
        ("Flags", ctypes.c_int),
        ("DimensionCount", wintypes.DWORD),
        ("Sizes", ctypes.c_void_p),
        ("Strides", ctypes.c_void_p),
        ("TotalTensorSizeInBytes", ctypes.c_ulonglong),
        ("GuaranteedBaseOffsetAlignment", wintypes.DWORD),
    ]
#[repr(C)]
pub struct DML_BUFFER_TENSOR_DESC {
    pub DataType: i32,
    pub Flags: i32,
    pub DimensionCount: u32,
    pub Sizes: *mut core::ffi::c_void,
    pub Strides: *mut core::ffi::c_void,
    pub TotalTensorSizeInBytes: u64,
    pub GuaranteedBaseOffsetAlignment: u32,
}
import "golang.org/x/sys/windows"

type DML_BUFFER_TENSOR_DESC struct {
	DataType int32
	Flags int32
	DimensionCount uint32
	Sizes uintptr
	Strides uintptr
	TotalTensorSizeInBytes uint64
	GuaranteedBaseOffsetAlignment uint32
}
type
  DML_BUFFER_TENSOR_DESC = record
    DataType: Integer;
    Flags: Integer;
    DimensionCount: DWORD;
    Sizes: Pointer;
    Strides: Pointer;
    TotalTensorSizeInBytes: UInt64;
    GuaranteedBaseOffsetAlignment: DWORD;
  end;
const DML_BUFFER_TENSOR_DESC = extern struct {
    DataType: i32,
    Flags: i32,
    DimensionCount: u32,
    Sizes: ?*anyopaque,
    Strides: ?*anyopaque,
    TotalTensorSizeInBytes: u64,
    GuaranteedBaseOffsetAlignment: u32,
};
type
  DML_BUFFER_TENSOR_DESC {.bycopy.} = object
    DataType: int32
    Flags: int32
    DimensionCount: uint32
    Sizes: pointer
    Strides: pointer
    TotalTensorSizeInBytes: uint64
    GuaranteedBaseOffsetAlignment: uint32
struct DML_BUFFER_TENSOR_DESC
{
    int DataType;
    int Flags;
    uint DimensionCount;
    void* Sizes;
    void* Strides;
    ulong TotalTensorSizeInBytes;
    uint GuaranteedBaseOffsetAlignment;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DML_BUFFER_TENSOR_DESC サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; DataType : DML_TENSOR_DATA_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Flags : DML_TENSOR_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DimensionCount : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Sizes : DWORD* (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Strides : DWORD* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; TotalTensorSizeInBytes : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; GuaranteedBaseOffsetAlignment : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DML_BUFFER_TENSOR_DESC サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; DataType : DML_TENSOR_DATA_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Flags : DML_TENSOR_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DimensionCount : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Sizes : DWORD* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Strides : DWORD* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; TotalTensorSizeInBytes : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; GuaranteedBaseOffsetAlignment : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DML_BUFFER_TENSOR_DESC
    #field int DataType
    #field int Flags
    #field int DimensionCount
    #field intptr Sizes
    #field intptr Strides
    #field int64 TotalTensorSizeInBytes
    #field int GuaranteedBaseOffsetAlignment
#endstruct

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