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

D3D12_INFO_QUEUE_FILTER_DESC

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

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

フィールド

フィールド型サイズx64x86説明
NumCategoriesDWORD4+0+0許可または拒否するメッセージカテゴリの数です。
pCategoryListD3D12_MESSAGE_CATEGORY*8/4+8+4許可または拒否するメッセージカテゴリの配列です。配列には少なくとも NumCategories 個のメンバーが必要です (D3D12_MESSAGE_CATEGORY を参照してください)。
NumSeveritiesDWORD4+16+8許可または拒否するメッセージ重大度レベルの数です。
pSeverityListD3D12_MESSAGE_SEVERITY*8/4+24+12許可または拒否するメッセージ重大度レベルの配列です。配列には少なくとも NumSeverities 個のメンバーが必要です (D3D12_MESSAGE_SEVERITY を参照してください)。
NumIDsDWORD4+32+16許可または拒否するメッセージ ID の数です。
pIDListD3D12_MESSAGE_ID*8/4+40+20許可または拒否するメッセージ ID の配列です。配列には少なくとも NumIDs 個のメンバーが必要です (D3D12_MESSAGE_ID を参照してください)。

公式ドキュメント

特定の種類のメッセージについて、フィルターの通過を許可または拒否します。

解説(Remarks)

ID3D12InfoQueue インターフェイスで使用します。

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

各言語での定義

#include <windows.h>

// D3D12_INFO_QUEUE_FILTER_DESC  (x64 48 / x86 24 バイト)
typedef struct D3D12_INFO_QUEUE_FILTER_DESC {
    DWORD NumCategories;
    D3D12_MESSAGE_CATEGORY* pCategoryList;
    DWORD NumSeverities;
    D3D12_MESSAGE_SEVERITY* pSeverityList;
    DWORD NumIDs;
    D3D12_MESSAGE_ID* pIDList;
} D3D12_INFO_QUEUE_FILTER_DESC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_INFO_QUEUE_FILTER_DESC
{
    public uint NumCategories;
    public IntPtr pCategoryList;
    public uint NumSeverities;
    public IntPtr pSeverityList;
    public uint NumIDs;
    public IntPtr pIDList;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_INFO_QUEUE_FILTER_DESC
    Public NumCategories As UInteger
    Public pCategoryList As IntPtr
    Public NumSeverities As UInteger
    Public pSeverityList As IntPtr
    Public NumIDs As UInteger
    Public pIDList As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class D3D12_INFO_QUEUE_FILTER_DESC(ctypes.Structure):
    _fields_ = [
        ("NumCategories", wintypes.DWORD),
        ("pCategoryList", ctypes.c_void_p),
        ("NumSeverities", wintypes.DWORD),
        ("pSeverityList", ctypes.c_void_p),
        ("NumIDs", wintypes.DWORD),
        ("pIDList", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct D3D12_INFO_QUEUE_FILTER_DESC {
    pub NumCategories: u32,
    pub pCategoryList: *mut core::ffi::c_void,
    pub NumSeverities: u32,
    pub pSeverityList: *mut core::ffi::c_void,
    pub NumIDs: u32,
    pub pIDList: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type D3D12_INFO_QUEUE_FILTER_DESC struct {
	NumCategories uint32
	pCategoryList uintptr
	NumSeverities uint32
	pSeverityList uintptr
	NumIDs uint32
	pIDList uintptr
}
type
  D3D12_INFO_QUEUE_FILTER_DESC = record
    NumCategories: DWORD;
    pCategoryList: Pointer;
    NumSeverities: DWORD;
    pSeverityList: Pointer;
    NumIDs: DWORD;
    pIDList: Pointer;
  end;
const D3D12_INFO_QUEUE_FILTER_DESC = extern struct {
    NumCategories: u32,
    pCategoryList: ?*anyopaque,
    NumSeverities: u32,
    pSeverityList: ?*anyopaque,
    NumIDs: u32,
    pIDList: ?*anyopaque,
};
type
  D3D12_INFO_QUEUE_FILTER_DESC {.bycopy.} = object
    NumCategories: uint32
    pCategoryList: pointer
    NumSeverities: uint32
    pSeverityList: pointer
    NumIDs: uint32
    pIDList: pointer
struct D3D12_INFO_QUEUE_FILTER_DESC
{
    uint NumCategories;
    void* pCategoryList;
    uint NumSeverities;
    void* pSeverityList;
    uint NumIDs;
    void* pIDList;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; D3D12_INFO_QUEUE_FILTER_DESC サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; NumCategories : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pCategoryList : D3D12_MESSAGE_CATEGORY* (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; NumSeverities : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pSeverityList : D3D12_MESSAGE_SEVERITY* (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; NumIDs : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pIDList : D3D12_MESSAGE_ID* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_INFO_QUEUE_FILTER_DESC サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; NumCategories : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pCategoryList : D3D12_MESSAGE_CATEGORY* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; NumSeverities : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pSeverityList : D3D12_MESSAGE_SEVERITY* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; NumIDs : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pIDList : D3D12_MESSAGE_ID* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_INFO_QUEUE_FILTER_DESC
    #field int NumCategories
    #field intptr pCategoryList
    #field int NumSeverities
    #field intptr pSeverityList
    #field int NumIDs
    #field intptr pIDList
#endstruct

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