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

D3D12_DESCRIPTOR_RANGE1

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

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

フィールド

フィールド型サイズx64x86説明
RangeTypeD3D12_DESCRIPTOR_RANGE_TYPE4+0+0ディスクリプタ範囲の種別。SRV/UAV/CBV/サンプラーを指定する。
NumDescriptorsDWORD4+4+4この範囲のディスクリプタ数。
BaseShaderRegisterDWORD4+8+8範囲の開始シェーダーレジスタ番号。
RegisterSpaceDWORD4+12+12シェーダーレジスタ空間の番号。
FlagsD3D12_DESCRIPTOR_RANGE_FLAGS4+16+16ディスクリプタ範囲のフラグ。揮発性やデータ静的性などを指定する。
OffsetInDescriptorsFromTableStartDWORD4+20+20テーブル先頭からのディスクリプタオフセット。

各言語での定義

#include <windows.h>

// D3D12_DESCRIPTOR_RANGE1  (x64 24 / x86 24 バイト)
typedef struct D3D12_DESCRIPTOR_RANGE1 {
    D3D12_DESCRIPTOR_RANGE_TYPE RangeType;
    DWORD NumDescriptors;
    DWORD BaseShaderRegister;
    DWORD RegisterSpace;
    D3D12_DESCRIPTOR_RANGE_FLAGS Flags;
    DWORD OffsetInDescriptorsFromTableStart;
} D3D12_DESCRIPTOR_RANGE1;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_DESCRIPTOR_RANGE1
{
    public int RangeType;
    public uint NumDescriptors;
    public uint BaseShaderRegister;
    public uint RegisterSpace;
    public int Flags;
    public uint OffsetInDescriptorsFromTableStart;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_DESCRIPTOR_RANGE1
    Public RangeType As Integer
    Public NumDescriptors As UInteger
    Public BaseShaderRegister As UInteger
    Public RegisterSpace As UInteger
    Public Flags As Integer
    Public OffsetInDescriptorsFromTableStart As UInteger
End Structure
import ctypes
from ctypes import wintypes

class D3D12_DESCRIPTOR_RANGE1(ctypes.Structure):
    _fields_ = [
        ("RangeType", ctypes.c_int),
        ("NumDescriptors", wintypes.DWORD),
        ("BaseShaderRegister", wintypes.DWORD),
        ("RegisterSpace", wintypes.DWORD),
        ("Flags", ctypes.c_int),
        ("OffsetInDescriptorsFromTableStart", wintypes.DWORD),
    ]
#[repr(C)]
pub struct D3D12_DESCRIPTOR_RANGE1 {
    pub RangeType: i32,
    pub NumDescriptors: u32,
    pub BaseShaderRegister: u32,
    pub RegisterSpace: u32,
    pub Flags: i32,
    pub OffsetInDescriptorsFromTableStart: u32,
}
import "golang.org/x/sys/windows"

type D3D12_DESCRIPTOR_RANGE1 struct {
	RangeType int32
	NumDescriptors uint32
	BaseShaderRegister uint32
	RegisterSpace uint32
	Flags int32
	OffsetInDescriptorsFromTableStart uint32
}
type
  D3D12_DESCRIPTOR_RANGE1 = record
    RangeType: Integer;
    NumDescriptors: DWORD;
    BaseShaderRegister: DWORD;
    RegisterSpace: DWORD;
    Flags: Integer;
    OffsetInDescriptorsFromTableStart: DWORD;
  end;
const D3D12_DESCRIPTOR_RANGE1 = extern struct {
    RangeType: i32,
    NumDescriptors: u32,
    BaseShaderRegister: u32,
    RegisterSpace: u32,
    Flags: i32,
    OffsetInDescriptorsFromTableStart: u32,
};
type
  D3D12_DESCRIPTOR_RANGE1 {.bycopy.} = object
    RangeType: int32
    NumDescriptors: uint32
    BaseShaderRegister: uint32
    RegisterSpace: uint32
    Flags: int32
    OffsetInDescriptorsFromTableStart: uint32
struct D3D12_DESCRIPTOR_RANGE1
{
    int RangeType;
    uint NumDescriptors;
    uint BaseShaderRegister;
    uint RegisterSpace;
    int Flags;
    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_RANGE1 サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 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 も可)
; Flags : D3D12_DESCRIPTOR_RANGE_FLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; OffsetInDescriptorsFromTableStart : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_DESCRIPTOR_RANGE1
    #field int RangeType
    #field int NumDescriptors
    #field int BaseShaderRegister
    #field int RegisterSpace
    #field int Flags
    #field int OffsetInDescriptorsFromTableStart
#endstruct

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