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

D3D11_TEXTURE1D_DESC

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

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

フィールド

フィールド型サイズx64x86説明
WidthDWORD4+0+0テクスチャの幅 (テクセル単位)。範囲は 1 から D3D11_REQ_TEXTURE1D_U_DIMENSION (16384) までです。ただし実際の範囲は、レンダリング デバイスを作成した機能レベルによって制約されます。制限の詳細については、「解説」を参照してください。
MipLevelsDWORD4+4+4テクスチャ内のミップマップ レベルの最大数。D3D11_TEX1D_SRV の解説を参照してください。マルチサンプル テクスチャの場合は 1 を使用します。サブテクスチャの完全なセットを生成するには 0 を使用します。
ArraySizeDWORD4+8+8配列内のテクスチャの数。範囲は 1 から D3D11_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION (2048) までです。ただし実際の範囲は、レンダリング デバイスを作成した機能レベルによって制約されます。制限の詳細については、「解説」を参照してください。
FormatDXGI_FORMAT4+12+12テクスチャのフォーマット (DXGI_FORMAT を参照)。
UsageD3D11_USAGE4+16+16テクスチャの読み取り方法および書き込み方法を示す値。最も一般的な値は D3D11_USAGE_DEFAULT です。指定できるすべての値については D3D11_USAGE を参照してください。
BindFlagsDWORD4+20+20パイプライン ステージにバインドするためのフラグ (D3D11_BIND_FLAG を参照)。これらのフラグはビット単位の OR で組み合わせることができます。1D テクスチャの場合に指定できる値は、D3D11_BIND_SHADER_RESOURCE、D3D11_BIND_RENDER_TARGET、D3D11_BIND_DEPTH_STENCIL です。
CPUAccessFlagsDWORD4+24+24許可する CPU アクセスの種類を指定するフラグ (D3D11_CPU_ACCESS_FLAG を参照)。CPU アクセスが不要な場合は 0 を使用します。これらのフラグはビット単位の OR で組み合わせることができます。
MiscFlagsDWORD4+28+28あまり一般的ではないその他のリソース オプションを示すフラグ (D3D11_RESOURCE_MISC_FLAG を参照)。いずれのフラグも該当しない場合は 0 を使用します。これらのフラグはビット単位の OR で組み合わせることができます。

公式ドキュメント

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

解説(Remarks)

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

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

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

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

各言語での定義

#include <windows.h>

// D3D11_TEXTURE1D_DESC  (x64 32 / x86 32 バイト)
typedef struct D3D11_TEXTURE1D_DESC {
    DWORD Width;
    DWORD MipLevels;
    DWORD ArraySize;
    DXGI_FORMAT Format;
    D3D11_USAGE Usage;
    DWORD BindFlags;
    DWORD CPUAccessFlags;
    DWORD MiscFlags;
} D3D11_TEXTURE1D_DESC;
using System;
using System.Runtime.InteropServices;

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

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

class D3D11_TEXTURE1D_DESC(ctypes.Structure):
    _fields_ = [
        ("Width", wintypes.DWORD),
        ("MipLevels", wintypes.DWORD),
        ("ArraySize", wintypes.DWORD),
        ("Format", ctypes.c_int),
        ("Usage", ctypes.c_int),
        ("BindFlags", wintypes.DWORD),
        ("CPUAccessFlags", wintypes.DWORD),
        ("MiscFlags", wintypes.DWORD),
    ]
#[repr(C)]
pub struct D3D11_TEXTURE1D_DESC {
    pub Width: u32,
    pub MipLevels: u32,
    pub ArraySize: u32,
    pub Format: i32,
    pub Usage: i32,
    pub BindFlags: u32,
    pub CPUAccessFlags: u32,
    pub MiscFlags: u32,
}
import "golang.org/x/sys/windows"

type D3D11_TEXTURE1D_DESC struct {
	Width uint32
	MipLevels uint32
	ArraySize uint32
	Format int32
	Usage int32
	BindFlags uint32
	CPUAccessFlags uint32
	MiscFlags uint32
}
type
  D3D11_TEXTURE1D_DESC = record
    Width: DWORD;
    MipLevels: DWORD;
    ArraySize: DWORD;
    Format: Integer;
    Usage: Integer;
    BindFlags: DWORD;
    CPUAccessFlags: DWORD;
    MiscFlags: DWORD;
  end;
const D3D11_TEXTURE1D_DESC = extern struct {
    Width: u32,
    MipLevels: u32,
    ArraySize: u32,
    Format: i32,
    Usage: i32,
    BindFlags: u32,
    CPUAccessFlags: u32,
    MiscFlags: u32,
};
type
  D3D11_TEXTURE1D_DESC {.bycopy.} = object
    Width: uint32
    MipLevels: uint32
    ArraySize: uint32
    Format: int32
    Usage: int32
    BindFlags: uint32
    CPUAccessFlags: uint32
    MiscFlags: uint32
struct D3D11_TEXTURE1D_DESC
{
    uint Width;
    uint MipLevels;
    uint ArraySize;
    int Format;
    int Usage;
    uint BindFlags;
    uint CPUAccessFlags;
    uint MiscFlags;
}

HSP用 定義

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

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

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