ホーム › Graphics.Direct3D12 › D3D12_DESCRIPTOR_RANGE

D3D12_DESCRIPTOR_RANGE

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
RangeType	D3D12_DESCRIPTOR_RANGE_TYPE	4	+0	+0	ディスクリプター範囲の種類を指定する D3D12_DESCRIPTOR_RANGE_TYPE 型の値です。
NumDescriptors	DWORD	4	+4	+4	範囲内のディスクリプターの数です。サイズが非有界であることを指定するには、-1 または UINT_MAX を使用します。あるディスクリプター範囲が非有界である場合、その範囲はテーブル定義内の最後の範囲でなければなりません。そうでない場合は、テーブル定義内の次の範囲の OffsetInDescriptorsFromTableStart が D3D12_DESCRIPTOR_RANGE_OFFSET_APPEND 以外の値を持つ必要があります。
BaseShaderRegister	DWORD	4	+8	+8	範囲内の基準となるシェーダーレジスターです。たとえばシェーダーリソースビュー (SRV) の場合、3 は HLSL の ": register(t3);" に対応します。
RegisterSpace	DWORD	4	+12	+12	レジスター空間です。通常は 0 で構いませんが、これを指定することで、サイズが不明な複数のディスクリプター配列が重なって見えないようにできます。たとえば SRV の場合、BaseShaderRegister メンバーの説明の例を拡張すると、5 は HLSL の ": register(t3,space5);" に対応します。
OffsetInDescriptorsFromTableStart	DWORD	4	+16	+16	このパラメータースロットのルート引数値として設定されたディスクリプターテーブルの先頭からの、ディスクリプター単位のオフセットです。この値には D3D12_DESCRIPTOR_RANGE_OFFSET_APPEND を指定でき、その場合この範囲は直前の範囲の直後に続くことを示します。

公式ドキュメント

ディスクリプター範囲を記述します。

解説(Remarks)

この構造体は D3D12_ROOT_DESCRIPTOR_TABLE 構造体のメンバーです。

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

各言語での定義

#include <windows.h>

// D3D12_DESCRIPTOR_RANGE  (x64 20 / x86 20 バイト)
typedef struct D3D12_DESCRIPTOR_RANGE {
    D3D12_DESCRIPTOR_RANGE_TYPE RangeType;
    DWORD NumDescriptors;
    DWORD BaseShaderRegister;
    DWORD RegisterSpace;
    DWORD OffsetInDescriptorsFromTableStart;
} D3D12_DESCRIPTOR_RANGE;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_DESCRIPTOR_RANGE
{
    public int RangeType;
    public uint NumDescriptors;
    public uint BaseShaderRegister;
    public uint RegisterSpace;
    public uint OffsetInDescriptorsFromTableStart;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_DESCRIPTOR_RANGE
    Public RangeType As Integer
    Public NumDescriptors As UInteger
    Public BaseShaderRegister As UInteger
    Public RegisterSpace As UInteger
    Public OffsetInDescriptorsFromTableStart As UInteger
End Structure

import ctypes
from ctypes import wintypes

class D3D12_DESCRIPTOR_RANGE(ctypes.Structure):
    _fields_ = [
        ("RangeType", ctypes.c_int),
        ("NumDescriptors", wintypes.DWORD),
        ("BaseShaderRegister", wintypes.DWORD),
        ("RegisterSpace", wintypes.DWORD),
        ("OffsetInDescriptorsFromTableStart", wintypes.DWORD),
    ]

#[repr(C)]
pub struct D3D12_DESCRIPTOR_RANGE {
    pub RangeType: i32,
    pub NumDescriptors: u32,
    pub BaseShaderRegister: u32,
    pub RegisterSpace: u32,
    pub OffsetInDescriptorsFromTableStart: u32,
}

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

type D3D12_DESCRIPTOR_RANGE struct {
	RangeType int32
	NumDescriptors uint32
	BaseShaderRegister uint32
	RegisterSpace uint32
	OffsetInDescriptorsFromTableStart uint32
}

type
  D3D12_DESCRIPTOR_RANGE = record
    RangeType: Integer;
    NumDescriptors: DWORD;
    BaseShaderRegister: DWORD;
    RegisterSpace: DWORD;
    OffsetInDescriptorsFromTableStart: DWORD;
  end;

const D3D12_DESCRIPTOR_RANGE = extern struct {
    RangeType: i32,
    NumDescriptors: u32,
    BaseShaderRegister: u32,
    RegisterSpace: u32,
    OffsetInDescriptorsFromTableStart: u32,
};

type
  D3D12_DESCRIPTOR_RANGE {.bycopy.} = object
    RangeType: int32
    NumDescriptors: uint32
    BaseShaderRegister: uint32
    RegisterSpace: uint32
    OffsetInDescriptorsFromTableStart: uint32

struct D3D12_DESCRIPTOR_RANGE
{
    int RangeType;
    uint NumDescriptors;
    uint BaseShaderRegister;
    uint RegisterSpace;
    uint OffsetInDescriptorsFromTableStart;
}

HSP用定義

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

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

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_DESCRIPTOR_RANGE
    #field int RangeType
    #field int NumDescriptors
    #field int BaseShaderRegister
    #field int RegisterSpace
    #field int OffsetInDescriptorsFromTableStart
#endstruct

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