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

D3D11_TRACE_VALUE

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

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

フィールド

フィールドサイズx64x86説明
BitsDWORD16+0+0

トレース値を構成するビットの配列です。[0] 要素は X です。

Note このメンバーは floatUINT、または INT のデータを保持できます。 float の代入時に x86 で SNaN->QNaN の変換が発生するリスクを最小限に抑えるため、要素は共用体を使わずに UINT として指定されています。 ビットを表示する場合は、最後の段階で float として解釈できます。
ValidMaskBYTE1+16+16

次のコンポーネント値をビット単位の OR 演算で組み合わせた値です。 結果の値は、コンポーネントのトレースマスクを指定します。

フラグ 説明
D3D11_TRACE_COMPONENT_X (0x1) トレースマスクの x 成分です。
D3D11_TRACE_COMPONENT_Y (0x2) トレースマスクの y 成分です。
D3D11_TRACE_COMPONENT_Z (0x4) トレースマスクの深度 z 成分です。
D3D11_TRACE_COMPONENT_W (0x8) トレースマスクの深度 w 成分です。

マスクされていない値は無視してください。特に差分を累積する場合は注意が必要です。

公式ドキュメント

トレース値を記述します。

解説(Remarks)

この API には、Windows 8 用の Windows ソフトウェア開発キット (SDK) が必要です。

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

各言語での定義

#include <windows.h>

// D3D11_TRACE_VALUE  (x64 20 / x86 20 バイト)
typedef struct D3D11_TRACE_VALUE {
    DWORD Bits[4];
    BYTE ValidMask;
} D3D11_TRACE_VALUE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D11_TRACE_VALUE
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] Bits;
    public byte ValidMask;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D11_TRACE_VALUE
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public Bits() As UInteger
    Public ValidMask As Byte
End Structure
import ctypes
from ctypes import wintypes

class D3D11_TRACE_VALUE(ctypes.Structure):
    _fields_ = [
        ("Bits", wintypes.DWORD * 4),
        ("ValidMask", ctypes.c_ubyte),
    ]
#[repr(C)]
pub struct D3D11_TRACE_VALUE {
    pub Bits: [u32; 4],
    pub ValidMask: u8,
}
import "golang.org/x/sys/windows"

type D3D11_TRACE_VALUE struct {
	Bits [4]uint32
	ValidMask byte
}
type
  D3D11_TRACE_VALUE = record
    Bits: array[0..3] of DWORD;
    ValidMask: Byte;
  end;
const D3D11_TRACE_VALUE = extern struct {
    Bits: [4]u32,
    ValidMask: u8,
};
type
  D3D11_TRACE_VALUE {.bycopy.} = object
    Bits: array[4, uint32]
    ValidMask: uint8
struct D3D11_TRACE_VALUE
{
    uint[4] Bits;
    ubyte ValidMask;
}

HSP用 定義

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

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

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