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

D3D11_TEXTURE2D_DESC1

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

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

フィールド

フィールドサイズx64x86説明
WidthDWORD4+0+0テクスチャの幅 (テクセル単位)。範囲は 1 から D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384) までです。テクスチャキューブマップの場合、範囲は 1 から D3D11_REQ_TEXTURECUBE_DIMENSION (16384) までです。ただし実際の範囲は、レンダリングデバイスを作成するときの 機能レベル によって制約されます。制限の詳細については、「解説」を参照してください。
HeightDWORD4+4+4テクスチャの高さ (テクセル単位)。範囲は 1 から D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384) までです。テクスチャキューブマップの場合、範囲は 1 から D3D11_REQ_TEXTURECUBE_DIMENSION (16384) までです。ただし実際の範囲は、レンダリングデバイスを作成するときの 機能レベル によって制約されます。制限の詳細については、「解説」を参照してください。
MipLevelsDWORD4+8+8テクスチャ内のミップマップレベルの最大数。D3D11_TEX1D_SRV の解説を参照してください。マルチサンプリングされたテクスチャの場合は 1 を使用します。サブテクスチャの完全なセットを生成するには 0 を使用します。
ArraySizeDWORD4+12+12テクスチャ配列内のテクスチャ数。範囲は 1 から D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048) までです。テクスチャキューブマップの場合、この値は 6 の倍数 (つまり D3D11_TEXCUBE_ARRAY_SRVNumCubes メンバーの値の 6 倍) であり、範囲は 6 から 2046 までです。実際の範囲は、レンダリングデバイスを作成するときの 機能レベル によって制約されます。制限の詳細については、「解説」を参照してください。
FormatDXGI_FORMAT4+16+16テクスチャのフォーマット (DXGI_FORMAT を参照)。
SampleDescDXGI_SAMPLE_DESC8+20+20テクスチャのマルチサンプリングパラメーターを指定する構造体。DXGI_SAMPLE_DESC を参照してください。
UsageD3D11_USAGE4+28+28テクスチャの読み取りおよび書き込みの方法を識別する値。最も一般的な値は D3D11_USAGE_DEFAULT です。指定可能なすべての値については D3D11_USAGE を参照してください。
BindFlagsDWORD4+32+32パイプラインステージへのバインドに使用するフラグ (D3D11_BIND_FLAG を参照)。これらのフラグはビット単位の OR で組み合わせることができます。
CPUAccessFlagsDWORD4+36+36許可する CPU アクセスの種類を指定するフラグ (D3D11_CPU_ACCESS_FLAG を参照)。CPU アクセスが不要な場合は 0 を使用します。これらのフラグはビット単位の OR で組み合わせることができます。
MiscFlagsDWORD4+40+40あまり一般的でないその他のリソースオプションを識別するフラグ (D3D11_RESOURCE_MISC_FLAG を参照)。これらのフラグがいずれも該当しない場合は 0 を使用します。これらのフラグはビット単位の OR を使用して組み合わせることができます。テクスチャキューブマップの場合は、D3D11_RESOURCE_MISC_TEXTURECUBE フラグを設定します。キューブマップ配列 (つまり ArraySize > 6) には、機能レベル D3D_FEATURE_LEVEL_10_1 以上が必要です。
TextureLayoutD3D11_TEXTURE_LAYOUT4+44+44

テクスチャのレイアウトを識別する D3D11_TEXTURE_LAYOUT 型の値。

TextureLayout パラメーターは、メモリ内でのテクスチャの実際のレイアウトと、テクスチャがマップされている間にアプリケーションから見えるレイアウトの両方を選択します。これらのフラグは、CPU アクセスも同時に要求しなければ指定できません。

既定のテクスチャに対して、TextureLayout に D3D11_TEXTURE_LAYOUT_UNDEFINED 以外の値を設定せずに CPU アクセスフラグを設定することはできません。

D3D11_TEXTURE_LAYOUT_ROW_MAJOR は、マルチサンプリングされていない、単一のサブリソースを持つテクスチャの作成にのみ使用できます (平面 YUV テクスチャはサポートされます)。これらのテクスチャはコピー操作のソースおよびコピー先としてのみ使用でき、BindFlags は 0 でなければなりません。

D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE は、マルチサンプリングされていない、深度ステンシルではないテクスチャの作成にのみ使用できます。

公式ドキュメント

2D テクスチャを記述します。

解説(Remarks)

この構造体は ID3D11Device3::CreateTexture2D1 の呼び出しで使用します。

この構造体のほかに、D3D11_3.h で定義され継承クラスのように動作する派生構造体 CD3D11_TEXTURE2D_DESC1 を使用して、テクスチャの記述を作成することもできます。

デバイスは、サブサンプリングされたリソース、ブロック圧縮リソース、またはビットフォーマットのリソースに対して、いくつかのサイズ制限 (最小サイズの倍数でなければならない) を課します。

テクスチャのサイズ範囲は、Microsoft Direct3D インターフェイスのバージョンではなく、デバイスを作成するときの 機能レベル によって決まります。たとえば、機能レベル 10 (D3D_FEATURE_LEVEL_10_0) の Microsoft Direct3D 10 ハードウェアを使用し、D3D11CreateDevice を呼び出して ID3D11Device を作成する場合は、2D テクスチャを作成するときに最大テクスチャサイズを D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192) に制限する必要があります。

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

各言語での定義

#include <windows.h>

// DXGI_SAMPLE_DESC  (x64 8 / x86 8 バイト)
typedef struct DXGI_SAMPLE_DESC {
    DWORD Count;
    DWORD Quality;
} DXGI_SAMPLE_DESC;

// D3D11_TEXTURE2D_DESC1  (x64 48 / x86 48 バイト)
typedef struct D3D11_TEXTURE2D_DESC1 {
    DWORD Width;
    DWORD Height;
    DWORD MipLevels;
    DWORD ArraySize;
    DXGI_FORMAT Format;
    DXGI_SAMPLE_DESC SampleDesc;
    D3D11_USAGE Usage;
    DWORD BindFlags;
    DWORD CPUAccessFlags;
    DWORD MiscFlags;
    D3D11_TEXTURE_LAYOUT TextureLayout;
} D3D11_TEXTURE2D_DESC1;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXGI_SAMPLE_DESC
{
    public uint Count;
    public uint Quality;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D11_TEXTURE2D_DESC1
{
    public uint Width;
    public uint Height;
    public uint MipLevels;
    public uint ArraySize;
    public int Format;
    public DXGI_SAMPLE_DESC SampleDesc;
    public int Usage;
    public uint BindFlags;
    public uint CPUAccessFlags;
    public uint MiscFlags;
    public int TextureLayout;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXGI_SAMPLE_DESC
    Public Count As UInteger
    Public Quality As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D11_TEXTURE2D_DESC1
    Public Width As UInteger
    Public Height As UInteger
    Public MipLevels As UInteger
    Public ArraySize As UInteger
    Public Format As Integer
    Public SampleDesc As DXGI_SAMPLE_DESC
    Public Usage As Integer
    Public BindFlags As UInteger
    Public CPUAccessFlags As UInteger
    Public MiscFlags As UInteger
    Public TextureLayout As Integer
End Structure
import ctypes
from ctypes import wintypes

class DXGI_SAMPLE_DESC(ctypes.Structure):
    _fields_ = [
        ("Count", wintypes.DWORD),
        ("Quality", wintypes.DWORD),
    ]

class D3D11_TEXTURE2D_DESC1(ctypes.Structure):
    _fields_ = [
        ("Width", wintypes.DWORD),
        ("Height", wintypes.DWORD),
        ("MipLevels", wintypes.DWORD),
        ("ArraySize", wintypes.DWORD),
        ("Format", ctypes.c_int),
        ("SampleDesc", DXGI_SAMPLE_DESC),
        ("Usage", ctypes.c_int),
        ("BindFlags", wintypes.DWORD),
        ("CPUAccessFlags", wintypes.DWORD),
        ("MiscFlags", wintypes.DWORD),
        ("TextureLayout", ctypes.c_int),
    ]
#[repr(C)]
pub struct DXGI_SAMPLE_DESC {
    pub Count: u32,
    pub Quality: u32,
}

#[repr(C)]
pub struct D3D11_TEXTURE2D_DESC1 {
    pub Width: u32,
    pub Height: u32,
    pub MipLevels: u32,
    pub ArraySize: u32,
    pub Format: i32,
    pub SampleDesc: DXGI_SAMPLE_DESC,
    pub Usage: i32,
    pub BindFlags: u32,
    pub CPUAccessFlags: u32,
    pub MiscFlags: u32,
    pub TextureLayout: i32,
}
import "golang.org/x/sys/windows"

type DXGI_SAMPLE_DESC struct {
	Count uint32
	Quality uint32
}

type D3D11_TEXTURE2D_DESC1 struct {
	Width uint32
	Height uint32
	MipLevels uint32
	ArraySize uint32
	Format int32
	SampleDesc DXGI_SAMPLE_DESC
	Usage int32
	BindFlags uint32
	CPUAccessFlags uint32
	MiscFlags uint32
	TextureLayout int32
}
type
  DXGI_SAMPLE_DESC = record
    Count: DWORD;
    Quality: DWORD;
  end;

  D3D11_TEXTURE2D_DESC1 = record
    Width: DWORD;
    Height: DWORD;
    MipLevels: DWORD;
    ArraySize: DWORD;
    Format: Integer;
    SampleDesc: DXGI_SAMPLE_DESC;
    Usage: Integer;
    BindFlags: DWORD;
    CPUAccessFlags: DWORD;
    MiscFlags: DWORD;
    TextureLayout: Integer;
  end;
const DXGI_SAMPLE_DESC = extern struct {
    Count: u32,
    Quality: u32,
};

const D3D11_TEXTURE2D_DESC1 = extern struct {
    Width: u32,
    Height: u32,
    MipLevels: u32,
    ArraySize: u32,
    Format: i32,
    SampleDesc: DXGI_SAMPLE_DESC,
    Usage: i32,
    BindFlags: u32,
    CPUAccessFlags: u32,
    MiscFlags: u32,
    TextureLayout: i32,
};
type
  DXGI_SAMPLE_DESC {.bycopy.} = object
    Count: uint32
    Quality: uint32

  D3D11_TEXTURE2D_DESC1 {.bycopy.} = object
    Width: uint32
    Height: uint32
    MipLevels: uint32
    ArraySize: uint32
    Format: int32
    SampleDesc: DXGI_SAMPLE_DESC
    Usage: int32
    BindFlags: uint32
    CPUAccessFlags: uint32
    MiscFlags: uint32
    TextureLayout: int32
struct DXGI_SAMPLE_DESC
{
    uint Count;
    uint Quality;
}

struct D3D11_TEXTURE2D_DESC1
{
    uint Width;
    uint Height;
    uint MipLevels;
    uint ArraySize;
    int Format;
    DXGI_SAMPLE_DESC SampleDesc;
    int Usage;
    uint BindFlags;
    uint CPUAccessFlags;
    uint MiscFlags;
    int TextureLayout;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D11_TEXTURE2D_DESC1 サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Width : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Height : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; MipLevels : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ArraySize : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Format : DXGI_FORMAT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; SampleDesc : DXGI_SAMPLE_DESC (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; Usage : D3D11_USAGE (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; BindFlags : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; CPUAccessFlags : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; MiscFlags : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; TextureLayout : D3D11_TEXTURE_LAYOUT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DXGI_SAMPLE_DESC
    #field int Count
    #field int Quality
#endstruct

#defstruct global D3D11_TEXTURE2D_DESC1
    #field int Width
    #field int Height
    #field int MipLevels
    #field int ArraySize
    #field int Format
    #field DXGI_SAMPLE_DESC SampleDesc
    #field int Usage
    #field int BindFlags
    #field int CPUAccessFlags
    #field int MiscFlags
    #field int TextureLayout
#endstruct

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