ホーム › Graphics.Direct3D12 › D3D12_TEX2D_ARRAY_SRV

D3D12_TEX2D_ARRAY_SRV

構造体

サイズx64: 24 バイト / x86: 24 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
MostDetailedMip	DWORD	4	+0	+0	使用する最も詳細なミップマップレベルのインデックスです。この値は 0 から MipLevels -1 までの範囲になります(MipLevels は、ID3D12Device::CreateShaderResourceView がビューを作成する元の Texture2D の値です)。
MipLevels	DWORD	4	+4	+4	テクスチャのビューに対するミップマップレベルの最大数です。D3D12_TEX1D_SRV の解説を参照してください。 MostDetailedMip から最も詳細度の低いレベルまでのすべてのミップマップレベルを示すには、-1 を設定します。
FirstArraySlice	DWORD	4	+8	+8	テクスチャ配列内で使用する最初のテクスチャのインデックスです。
ArraySize	DWORD	4	+12	+12	配列内のテクスチャの数です。
PlaneSlice	DWORD	4	+16	+16	テクスチャ配列内で使用するプレーンのインデックス(プレーンスライス番号)です。
ResourceMinLODClamp	FLOAT	4	+20	+20	アクセスできる最小のミップマップレベルを指定します。0.0f を指定すると、すべてのミップマップレベルにアクセスできます。3.0f を指定すると、3.0f から MipCount - 1 までのミップマップレベルにアクセスできます。 MostDetailedMip と ResourceMinLODClamp を同時に設定しないことをお勧めします。代わりに、どちらか一方のメンバーを 0 に設定してください(既定の動作になります)。これは、組み合わせるフィールドによって MipLevels の解釈が異なるためです。 MostDetailedMip の場合、ミップの範囲は [MostDetailedMip, MostDetailedMip + MipLevels - 1] です。 ResourceMinLODClamp の場合、ミップの範囲は [ResourceMinLODClamp, MipLevels - 1] です。

公式ドキュメント

シェーダーリソースビューで使用する、2D テクスチャ配列のサブリソースを記述します。

解説(Remarks)

この構造体は、シェーダーリソースビューの記述子である D3D12_SHADER_RESOURCE_VIEW_DESC のメンバーの 1 つです。

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

各言語での定義

#include <windows.h>

// D3D12_TEX2D_ARRAY_SRV  (x64 24 / x86 24 バイト)
typedef struct D3D12_TEX2D_ARRAY_SRV {
    DWORD MostDetailedMip;
    DWORD MipLevels;
    DWORD FirstArraySlice;
    DWORD ArraySize;
    DWORD PlaneSlice;
    FLOAT ResourceMinLODClamp;
} D3D12_TEX2D_ARRAY_SRV;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_TEX2D_ARRAY_SRV
{
    public uint MostDetailedMip;
    public uint MipLevels;
    public uint FirstArraySlice;
    public uint ArraySize;
    public uint PlaneSlice;
    public float ResourceMinLODClamp;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_TEX2D_ARRAY_SRV
    Public MostDetailedMip As UInteger
    Public MipLevels As UInteger
    Public FirstArraySlice As UInteger
    Public ArraySize As UInteger
    Public PlaneSlice As UInteger
    Public ResourceMinLODClamp As Single
End Structure

import ctypes
from ctypes import wintypes

class D3D12_TEX2D_ARRAY_SRV(ctypes.Structure):
    _fields_ = [
        ("MostDetailedMip", wintypes.DWORD),
        ("MipLevels", wintypes.DWORD),
        ("FirstArraySlice", wintypes.DWORD),
        ("ArraySize", wintypes.DWORD),
        ("PlaneSlice", wintypes.DWORD),
        ("ResourceMinLODClamp", ctypes.c_float),
    ]

#[repr(C)]
pub struct D3D12_TEX2D_ARRAY_SRV {
    pub MostDetailedMip: u32,
    pub MipLevels: u32,
    pub FirstArraySlice: u32,
    pub ArraySize: u32,
    pub PlaneSlice: u32,
    pub ResourceMinLODClamp: f32,
}

import "golang.org/x/sys/windows"

type D3D12_TEX2D_ARRAY_SRV struct {
	MostDetailedMip uint32
	MipLevels uint32
	FirstArraySlice uint32
	ArraySize uint32
	PlaneSlice uint32
	ResourceMinLODClamp float32
}

type
  D3D12_TEX2D_ARRAY_SRV = record
    MostDetailedMip: DWORD;
    MipLevels: DWORD;
    FirstArraySlice: DWORD;
    ArraySize: DWORD;
    PlaneSlice: DWORD;
    ResourceMinLODClamp: Single;
  end;

const D3D12_TEX2D_ARRAY_SRV = extern struct {
    MostDetailedMip: u32,
    MipLevels: u32,
    FirstArraySlice: u32,
    ArraySize: u32,
    PlaneSlice: u32,
    ResourceMinLODClamp: f32,
};

type
  D3D12_TEX2D_ARRAY_SRV {.bycopy.} = object
    MostDetailedMip: uint32
    MipLevels: uint32
    FirstArraySlice: uint32
    ArraySize: uint32
    PlaneSlice: uint32
    ResourceMinLODClamp: float32

struct D3D12_TEX2D_ARRAY_SRV
{
    uint MostDetailedMip;
    uint MipLevels;
    uint FirstArraySlice;
    uint ArraySize;
    uint PlaneSlice;
    float ResourceMinLODClamp;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_TEX2D_ARRAY_SRV サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; MostDetailedMip : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; MipLevels : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; FirstArraySlice : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ArraySize : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; PlaneSlice : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ResourceMinLODClamp : FLOAT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_TEX2D_ARRAY_SRV
    #field int MostDetailedMip
    #field int MipLevels
    #field int FirstArraySlice
    #field int ArraySize
    #field int PlaneSlice
    #field float ResourceMinLODClamp
#endstruct

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