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

D3D11_BUFFER_DESC

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

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

フィールド

フィールド型サイズx64x86説明
ByteWidthDWORD4+0+0バッファーのサイズ (バイト単位)。
UsageD3D11_USAGE4+4+4バッファーの読み取りおよび書き込みが想定される方法を指定します。更新の頻度が重要な要素になります。最も一般的な値は通常 D3D11_USAGE_DEFAULT です。指定可能なすべての値については、D3D11_USAGE を参照してください。
BindFlagsDWORD4+8+8バッファーをパイプラインにどのようにバインドするかを指定します。フラグ (D3D11_BIND_FLAG を参照) はビット単位の OR で組み合わせることができます。
CPUAccessFlagsDWORD4+12+12CPU アクセスフラグ (D3D11_CPU_ACCESS_FLAG を参照)。CPU アクセスが不要な場合は 0 です。フラグはビット単位の OR で組み合わせることができます。
MiscFlagsDWORD4+16+16その他のフラグ (D3D11_RESOURCE_MISC_FLAG を参照)。使用しない場合は 0 です。フラグはビット単位の OR で組み合わせることができます。
StructureByteStrideDWORD4+20+20

バッファーが構造化バッファーを表す場合の、バッファー構造内の各要素のサイズ (バイト単位)。構造化バッファーの詳細については、Structured Buffer を参照してください。

StructureByteStride のサイズ値は、そのバッファーのビューに使用するフォーマットのサイズと一致していなければなりません。たとえば、ピクセルシェーダーでバッファーを読み取るためにシェーダーリソースビュー (SRV) を使用する場合、SRV のフォーマットのサイズは StructureByteStride のサイズ値と一致していなければなりません。

公式ドキュメント

バッファーリソースについて説明します。

解説(Remarks)

この構造体は、バッファーリソースを作成するために ID3D11Device::CreateBuffer で使用されます。

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

バインドフラグが D3D11_BIND_CONSTANT_BUFFER の場合、ByteWidth の値は 16 の倍数で、かつ D3D11_REQ_CONSTANT_BUFFER_ELEMENT_COUNT 以下でなければなりません。

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

各言語での定義

#include <windows.h>

// D3D11_BUFFER_DESC  (x64 24 / x86 24 バイト)
typedef struct D3D11_BUFFER_DESC {
    DWORD ByteWidth;
    D3D11_USAGE Usage;
    DWORD BindFlags;
    DWORD CPUAccessFlags;
    DWORD MiscFlags;
    DWORD StructureByteStride;
} D3D11_BUFFER_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D11_BUFFER_DESC
{
    public uint ByteWidth;
    public int Usage;
    public uint BindFlags;
    public uint CPUAccessFlags;
    public uint MiscFlags;
    public uint StructureByteStride;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D11_BUFFER_DESC
    Public ByteWidth As UInteger
    Public Usage As Integer
    Public BindFlags As UInteger
    Public CPUAccessFlags As UInteger
    Public MiscFlags As UInteger
    Public StructureByteStride As UInteger
End Structure
import ctypes
from ctypes import wintypes

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

type D3D11_BUFFER_DESC struct {
	ByteWidth uint32
	Usage int32
	BindFlags uint32
	CPUAccessFlags uint32
	MiscFlags uint32
	StructureByteStride uint32
}
type
  D3D11_BUFFER_DESC = record
    ByteWidth: DWORD;
    Usage: Integer;
    BindFlags: DWORD;
    CPUAccessFlags: DWORD;
    MiscFlags: DWORD;
    StructureByteStride: DWORD;
  end;
const D3D11_BUFFER_DESC = extern struct {
    ByteWidth: u32,
    Usage: i32,
    BindFlags: u32,
    CPUAccessFlags: u32,
    MiscFlags: u32,
    StructureByteStride: u32,
};
type
  D3D11_BUFFER_DESC {.bycopy.} = object
    ByteWidth: uint32
    Usage: int32
    BindFlags: uint32
    CPUAccessFlags: uint32
    MiscFlags: uint32
    StructureByteStride: uint32
struct D3D11_BUFFER_DESC
{
    uint ByteWidth;
    int Usage;
    uint BindFlags;
    uint CPUAccessFlags;
    uint MiscFlags;
    uint StructureByteStride;
}

HSP用 定義

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

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

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