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

D3D12_AUTO_BREADCRUMB_NODE

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

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

フィールド

フィールド型サイズx64x86説明
pCommandListDebugNameABYTE*8/4+0+0未完了のコマンドリストの ANSI デバッグ名へのポインター (存在する場合)。
pCommandListDebugNameWLPWSTR8/4+8+4未完了のコマンドリストのワイド文字デバッグ名へのポインター (存在する場合)。
pCommandQueueDebugNameABYTE*8/4+16+8未完了のコマンドキューの ANSI デバッグ名へのポインター (存在する場合)。
pCommandQueueDebugNameWLPWSTR8/4+24+12未完了のコマンドキューのワイド文字デバッグ名へのポインター (存在する場合)。
pCommandListID3D12GraphicsCommandList*8/4+32+16実行時点で未完了であったコマンドリストを表す ID3D12GraphicsCommandList インターフェイス へのポインター。
pCommandQueueID3D12CommandQueue*8/4+40+20未完了のコマンドキューを表す ID3D12CommandQueue インターフェイス へのポインター。
BreadcrumbCountDWORD4+48+24pCommandHistory が指す配列内の D3D12_AUTO_BREADCRUMB_OP 値の個数を格納する UINT32。
pLastBreadcrumbValueDWORD*8/4+56+28完了した pCommandHistory のブレッドクラム操作の数を格納する定数 UINT32 へのポインター。したがって、最後に正常に完了したブレッドクラム操作は、pCommandHistory 内のインデックス (*pLastBreadcrumbValue - 1) にあります。
pCommandHistoryD3D12_AUTO_BREADCRUMB_OP*8/4+64+32関連付けられたコマンドリストに記録されたすべてのレンダリング/コンピュート操作を表す、D3D12_AUTO_BREADCRUMB_OP 値の定数配列へのポインター。
pNextD3D12_AUTO_BREADCRUMB_NODE*8/4+72+36リスト内の次の自動ブレッドクラムノードを表す定数 D3D12_AUTO_BREADCRUMB_NODE へのポインター。これが最後のノードである場合は nullptr になります。

公式ドキュメント

Device Removed Extended Data (DRED) の自動ブレッドクラムデータを、連結リストのノードとして表します。各 D3D12_AUTO_BREADCRUMB_NODE オブジェクトは、pNext メンバーによって次のノードへ単方向に連結されます。ただし、リストの最後のノードは pNext が nullptr に設定されます。

Direct3D 12 ランタイムは、グラフィックスコマンドリストごとにこの構造体を 1 つ作成し、そのリストに関連付けられたコマンドアロケーター内で追跡します。コマンドリストが実行されると、コマンドキューの情報が設定されます。デバイスの削除が検出された後、Direct3D 12 ランタイムは、未完了の GPU 作業に対応する自動ブレッドクラムノードを相互に連結します。

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

各言語での定義

#include <windows.h>

// D3D12_AUTO_BREADCRUMB_NODE  (x64 80 / x86 40 バイト)
typedef struct D3D12_AUTO_BREADCRUMB_NODE {
    BYTE* pCommandListDebugNameA;
    LPWSTR pCommandListDebugNameW;
    BYTE* pCommandQueueDebugNameA;
    LPWSTR pCommandQueueDebugNameW;
    ID3D12GraphicsCommandList* pCommandList;
    ID3D12CommandQueue* pCommandQueue;
    DWORD BreadcrumbCount;
    DWORD* pLastBreadcrumbValue;
    D3D12_AUTO_BREADCRUMB_OP* pCommandHistory;
    D3D12_AUTO_BREADCRUMB_NODE* pNext;
} D3D12_AUTO_BREADCRUMB_NODE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_AUTO_BREADCRUMB_NODE
{
    public IntPtr pCommandListDebugNameA;
    public IntPtr pCommandListDebugNameW;
    public IntPtr pCommandQueueDebugNameA;
    public IntPtr pCommandQueueDebugNameW;
    public IntPtr pCommandList;
    public IntPtr pCommandQueue;
    public uint BreadcrumbCount;
    public IntPtr pLastBreadcrumbValue;
    public IntPtr pCommandHistory;
    public IntPtr pNext;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_AUTO_BREADCRUMB_NODE
    Public pCommandListDebugNameA As IntPtr
    Public pCommandListDebugNameW As IntPtr
    Public pCommandQueueDebugNameA As IntPtr
    Public pCommandQueueDebugNameW As IntPtr
    Public pCommandList As IntPtr
    Public pCommandQueue As IntPtr
    Public BreadcrumbCount As UInteger
    Public pLastBreadcrumbValue As IntPtr
    Public pCommandHistory As IntPtr
    Public pNext As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class D3D12_AUTO_BREADCRUMB_NODE(ctypes.Structure):
    _fields_ = [
        ("pCommandListDebugNameA", ctypes.c_void_p),
        ("pCommandListDebugNameW", ctypes.c_void_p),
        ("pCommandQueueDebugNameA", ctypes.c_void_p),
        ("pCommandQueueDebugNameW", ctypes.c_void_p),
        ("pCommandList", ctypes.c_void_p),
        ("pCommandQueue", ctypes.c_void_p),
        ("BreadcrumbCount", wintypes.DWORD),
        ("pLastBreadcrumbValue", ctypes.c_void_p),
        ("pCommandHistory", ctypes.c_void_p),
        ("pNext", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct D3D12_AUTO_BREADCRUMB_NODE {
    pub pCommandListDebugNameA: *mut core::ffi::c_void,
    pub pCommandListDebugNameW: *mut core::ffi::c_void,
    pub pCommandQueueDebugNameA: *mut core::ffi::c_void,
    pub pCommandQueueDebugNameW: *mut core::ffi::c_void,
    pub pCommandList: *mut core::ffi::c_void,
    pub pCommandQueue: *mut core::ffi::c_void,
    pub BreadcrumbCount: u32,
    pub pLastBreadcrumbValue: *mut core::ffi::c_void,
    pub pCommandHistory: *mut core::ffi::c_void,
    pub pNext: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type D3D12_AUTO_BREADCRUMB_NODE struct {
	pCommandListDebugNameA uintptr
	pCommandListDebugNameW uintptr
	pCommandQueueDebugNameA uintptr
	pCommandQueueDebugNameW uintptr
	pCommandList uintptr
	pCommandQueue uintptr
	BreadcrumbCount uint32
	pLastBreadcrumbValue uintptr
	pCommandHistory uintptr
	pNext uintptr
}
type
  D3D12_AUTO_BREADCRUMB_NODE = record
    pCommandListDebugNameA: Pointer;
    pCommandListDebugNameW: Pointer;
    pCommandQueueDebugNameA: Pointer;
    pCommandQueueDebugNameW: Pointer;
    pCommandList: Pointer;
    pCommandQueue: Pointer;
    BreadcrumbCount: DWORD;
    pLastBreadcrumbValue: Pointer;
    pCommandHistory: Pointer;
    pNext: Pointer;
  end;
const D3D12_AUTO_BREADCRUMB_NODE = extern struct {
    pCommandListDebugNameA: ?*anyopaque,
    pCommandListDebugNameW: ?*anyopaque,
    pCommandQueueDebugNameA: ?*anyopaque,
    pCommandQueueDebugNameW: ?*anyopaque,
    pCommandList: ?*anyopaque,
    pCommandQueue: ?*anyopaque,
    BreadcrumbCount: u32,
    pLastBreadcrumbValue: ?*anyopaque,
    pCommandHistory: ?*anyopaque,
    pNext: ?*anyopaque,
};
type
  D3D12_AUTO_BREADCRUMB_NODE {.bycopy.} = object
    pCommandListDebugNameA: pointer
    pCommandListDebugNameW: pointer
    pCommandQueueDebugNameA: pointer
    pCommandQueueDebugNameW: pointer
    pCommandList: pointer
    pCommandQueue: pointer
    BreadcrumbCount: uint32
    pLastBreadcrumbValue: pointer
    pCommandHistory: pointer
    pNext: pointer
struct D3D12_AUTO_BREADCRUMB_NODE
{
    void* pCommandListDebugNameA;
    void* pCommandListDebugNameW;
    void* pCommandQueueDebugNameA;
    void* pCommandQueueDebugNameW;
    void* pCommandList;
    void* pCommandQueue;
    uint BreadcrumbCount;
    void* pLastBreadcrumbValue;
    void* pCommandHistory;
    void* pNext;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; D3D12_AUTO_BREADCRUMB_NODE サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; pCommandListDebugNameA : BYTE* (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pCommandListDebugNameW : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pCommandQueueDebugNameA : BYTE* (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pCommandQueueDebugNameW : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pCommandList : ID3D12GraphicsCommandList* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pCommandQueue : ID3D12CommandQueue* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; BreadcrumbCount : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pLastBreadcrumbValue : DWORD* (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pCommandHistory : D3D12_AUTO_BREADCRUMB_OP* (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pNext : D3D12_AUTO_BREADCRUMB_NODE* (+36, 4byte)  varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_AUTO_BREADCRUMB_NODE サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; pCommandListDebugNameA : BYTE* (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pCommandListDebugNameW : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pCommandQueueDebugNameA : BYTE* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pCommandQueueDebugNameW : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pCommandList : ID3D12GraphicsCommandList* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pCommandQueue : ID3D12CommandQueue* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; BreadcrumbCount : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; pLastBreadcrumbValue : DWORD* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pCommandHistory : D3D12_AUTO_BREADCRUMB_OP* (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; pNext : D3D12_AUTO_BREADCRUMB_NODE* (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_AUTO_BREADCRUMB_NODE
    #field intptr pCommandListDebugNameA
    #field intptr pCommandListDebugNameW
    #field intptr pCommandQueueDebugNameA
    #field intptr pCommandQueueDebugNameW
    #field intptr pCommandList
    #field intptr pCommandQueue
    #field int BreadcrumbCount
    #field intptr pLastBreadcrumbValue
    #field intptr pCommandHistory
    #field intptr pNext
#endstruct

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