XBOX_DRIVER_HINT Enumeration

Hints for Xbox drivers, such as whether to enable gathering performance data about memory statistics.

Syntax

typedef enum XBOX_DRIVER_HINT
{
    XBOX_DRIVER_HINT_VRAM_SPILL_ENABLE = 1,
    XBOX_DRIVER_HINT_MEMORY_STATISTICS_ENABLE = 2,
    XBOX_DRIVER_HINT_STALL_STATISTICS_ENABLE = 3,
    XBOX_DRIVER_HINT_SYSMON_STATISTICS_ENABLE = 4,
    XBOX_DRIVER_HINT_CONSTANT_BUFFER_OFFSETS_IN_CONSTANTS = 6,
    XBOX_DRIVER_HINT_CPU_SINGLE_STEPPER_ENABLE = 9,
    XBOX_DRIVER_HINT_GPU_SINGLE_STEPPER_ENABLE = 10,
    XBOX_DRIVER_HINT_7_CONTEXT_ENABLE = 11,
    XBOX_DRIVER_HINT_OPTIMIZE_GPU_BLOCK_MEMORY_PRIORITIES = 12,
    XBOX_DRIVER_HINT_DEBUG_BREAK_ON_SHADER_COMPILATION = 13,
    XBOX_DRIVER_HINT_REDUCE_KICKOFF_CONTEXT_ROLLS = 14,
    XBOX_DRIVER_HINT_LEGACY_TILE_MODE_SELECTIONS = 15,
    XBOX_DRIVER_HINT_ENABLE_D3D12_DMA_CMDQUEU_FENCE_VALIDATION = 21
} XBOX_DRIVER_HINT;

Constants

Constant	Description
XBOX_DRIVER_HINT_VRAM_SPILL_ENABLE	Deprecated. Enables or disables the driver placing VRAM-designated allocations in system memory if VRAM fills up. This option is enabled by default. If VRAM spill is disabled and VRAM fills up, creation of further VRAM-designated allocations (DEFAULT, IMMUTABLE usage resources) will fail with E_OUTOFMEMORY.
XBOX_DRIVER_HINT_MEMORY_STATISTICS_ENABLE	Enables or disables detailed memory statistics sent to kernel debug out. This option is disabled by default.
XBOX_DRIVER_HINT_STALL_STATISTICS_ENABLE	Enables or disables CPU stall reporting to title debug out. This option is disabled by default.
XBOX_DRIVER_HINT_SYSMON_STATISTICS_ENABLE	Enables or disables PIX Sysmon counter snapshots to title debug out every 5 seconds. This option is disabled by default.
XBOX_DRIVER_HINT_CONSTANT_BUFFER_OFFSETS_IN_CONSTANTS	Deprecated.
XBOX_DRIVER_HINT_CPU_SINGLE_STEPPER_ENABLE	Enables CPU single-stepper.
XBOX_DRIVER_HINT_GPU_SINGLE_STEPPER_ENABLE	Enables GPU single-stepper.
XBOX_DRIVER_HINT_7_CONTEXT_ENABLE	Enables 7 context.
XBOX_DRIVER_HINT_OPTIMIZE_GPU_BLOCK_MEMORY_PRIORITIES	Optimizes GPU block memory priorities.
XBOX_DRIVER_HINT_DEBUG_BREAK_ON_SHADER_COMPILATION	Enables a debug break when the shader compiler is invoked to compile a shader at runtime.
XBOX_DRIVER_HINT_REDUCE_KICKOFF_CONTEXT_ROLLS	Enables an optimization at graphics IB1 segment kickoff time that eliminates an automatic context roll. This optimization is enabled by default; this driver hint can be used to disable the optimization with a value of 0.
XBOX_DRIVER_HINT_LEGACY_TILE_MODE_SELECTIONS	Legacy tile mode selections. In the August 2015 XDK and later, the default is 1D tiling for non-render target textures. Earlier XDK releases defaulted to a 2D tiling value. You can use this driver hint if you want a 2D tiling value, to maintain compatibility with stored disc resources, for example when patching a title built on a pre-August 2015 XDK.
XBOX_DRIVER_HINT_ENABLE_D3D12_DMA_CMDQUEU_FENCE_VALIDATION	Enables or disables validation of fences on DMA command queues.

Remarks

These enumeration constants are passed-in as the Feature parameter of the method ID3D11DeviceX::SetDriverHint.

Requirements

Header: Declared in d3d11_x.h (d3d11_1.h on other Windows platforms).

Library: Use d3d11_x.lib (d3d11.lib on other Windows platforms).