Win32 API 日本語リファレンス
ホームGraphics.Direct3D12 › D3D12_META_COMMAND_PARAMETER_DESC

D3D12_META_COMMAND_PARAMETER_DESC

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

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

フィールド

フィールドサイズx64x86説明
NameLPWSTR8/4+0+0パラメーター名です。
TypeD3D12_META_COMMAND_PARAMETER_TYPE4+8+4パラメーターの型を指定する D3D12_META_COMMAND_PARAMETER_TYPE です。
FlagsD3D12_META_COMMAND_PARAMETER_FLAGS4+12+8パラメーターのフラグを指定する D3D12_META_COMMAND_PARAMETER_FLAGS です。
RequiredResourceStateD3D12_RESOURCE_STATES4+16+12リソースパラメーターに期待される状態を指定する D3D12_RESOURCE_STATES です。
StructureOffsetDWORD4+20+16このパラメーターの 4 バイト境界に整列されたオフセットです。このオフセットは、メタコマンドの作成/初期化/実行の際に必要に応じて渡す、パラメーター値を格納した構造体内での位置を示します。

公式ドキュメント

メタコマンドのパラメーターを記述します。

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

各言語での定義

#include <windows.h>

// D3D12_META_COMMAND_PARAMETER_DESC  (x64 24 / x86 20 バイト)
typedef struct D3D12_META_COMMAND_PARAMETER_DESC {
    LPWSTR Name;
    D3D12_META_COMMAND_PARAMETER_TYPE Type;
    D3D12_META_COMMAND_PARAMETER_FLAGS Flags;
    D3D12_RESOURCE_STATES RequiredResourceState;
    DWORD StructureOffset;
} D3D12_META_COMMAND_PARAMETER_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_META_COMMAND_PARAMETER_DESC
{
    public IntPtr Name;
    public int Type;
    public int Flags;
    public int RequiredResourceState;
    public uint StructureOffset;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_META_COMMAND_PARAMETER_DESC
    Public Name As IntPtr
    Public Type As Integer
    Public Flags As Integer
    Public RequiredResourceState As Integer
    Public StructureOffset As UInteger
End Structure
import ctypes
from ctypes import wintypes

class D3D12_META_COMMAND_PARAMETER_DESC(ctypes.Structure):
    _fields_ = [
        ("Name", ctypes.c_void_p),
        ("Type", ctypes.c_int),
        ("Flags", ctypes.c_int),
        ("RequiredResourceState", ctypes.c_int),
        ("StructureOffset", wintypes.DWORD),
    ]
#[repr(C)]
pub struct D3D12_META_COMMAND_PARAMETER_DESC {
    pub Name: *mut core::ffi::c_void,
    pub Type: i32,
    pub Flags: i32,
    pub RequiredResourceState: i32,
    pub StructureOffset: u32,
}
import "golang.org/x/sys/windows"

type D3D12_META_COMMAND_PARAMETER_DESC struct {
	Name uintptr
	Type int32
	Flags int32
	RequiredResourceState int32
	StructureOffset uint32
}
type
  D3D12_META_COMMAND_PARAMETER_DESC = record
    Name: Pointer;
    Type: Integer;
    Flags: Integer;
    RequiredResourceState: Integer;
    StructureOffset: DWORD;
  end;
const D3D12_META_COMMAND_PARAMETER_DESC = extern struct {
    Name: ?*anyopaque,
    Type: i32,
    Flags: i32,
    RequiredResourceState: i32,
    StructureOffset: u32,
};
type
  D3D12_META_COMMAND_PARAMETER_DESC {.bycopy.} = object
    Name: pointer
    Type: int32
    Flags: int32
    RequiredResourceState: int32
    StructureOffset: uint32
struct D3D12_META_COMMAND_PARAMETER_DESC
{
    void* Name;
    int Type;
    int Flags;
    int RequiredResourceState;
    uint StructureOffset;
}

HSP用 定義

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

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

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