ID3D12Device::SetDebugErrorFilterX Method

Apply validation error filtering targeted at the granularity of a DEBUG output message.

Syntax

public:
HRESULT SetDebugErrorFilterX(
         UINT ErrorIdentifier,
         D3D12XBOX_DEBUG_FILTER_FLAGS FilterFlags
)

Parameters

ErrorIdentifier
Type: UINT

[in] Identifier of the error to filter.

FilterFlags
Type: D3D12XBOX_DEBUG_FILTER_FLAGS

[in] Flags to specify the debugging options to set, as a bitwise-OR’d combination of D3D12XBOX_DEBUG_FILTER_FLAGS.

Return value

Type: HRESULT

One of the Direct3D 12 return codes.

Remarks

Errors produced by the DEBUG graphics driver include in their output messages a 32 bit hexadecimal value (enclosed in brackets), used to identify individual failures and apply targeted filtering to them.

A union of D3D12XBOX_DEBUG_FILTER_FLAGS allows control over whether debugger output should be produced for an error, whether the user-supplied DEBUG_CALLBACK should be called, whether the debugger should be broken into, and/or whether a potential command list recording the failure should be invalidated.

Requirements

Header: Declared in d3d12_x.h.

Library: Use d3d12_x.lib.