estrutura D3D12_DEBUG_DEVICE_GPU_BASED_VALIDATION_SETTINGS (d3d12sdklayers.h)

Artigo
08/23/2023

Descreve as configurações usadas pelo GPU-Based Validação.

Sintaxe

typedef struct D3D12_DEBUG_DEVICE_GPU_BASED_VALIDATION_SETTINGS {
  UINT                                                   MaxMessagesPerCommandList;
  D3D12_GPU_BASED_VALIDATION_SHADER_PATCH_MODE           DefaultShaderPatchMode;
  D3D12_GPU_BASED_VALIDATION_PIPELINE_STATE_CREATE_FLAGS PipelineStateCreateFlags;
} D3D12_DEBUG_DEVICE_GPU_BASED_VALIDATION_SETTINGS;

Membros

MaxMessagesPerCommandList

Especifica um UINT que limita o número de mensagens que podem ser armazenadas no log de mensagens de validação GPU-Based. O valor padrão é 256. Como muitos erros idênticos podem ser produzidos em uma única chamada de Desenho/Expedição, pode ser útil aumentar esse número. Observe que isso pode se tornar uma carga de memória se um grande número de listas de comandos for usado, pois há um log de mensagens confirmado por lista de comandos.

DefaultShaderPatchMode

Especifica o D3D12_GPU_BASED_VALIDATION_SHADER_PATCH_MODE que GPU-Based Validação usa ao injetar código de validação em sombreadores, exceto quando substituído por configurações de validação de GPU-Based por comando (consulte D3D12_DEBUG_COMMAND_LIST_GPU_BASED_VALIDATION_SETTINGS). O valor padrão é D3D12_GPU_BASED_VALIDATION_SHADER_PATCH_MODE_UNGUARDED_VALIDATION.

PipelineStateCreateFlags

Especifica um dos D3D12_GPU_BASED_VALIDATION_PIPELINE_STATE_CREATE_FLAGS que indica como GPU-Based Validação lida com estados de pipeline de aplicação de patch. O valor padrão é D3D12_GPU_BASED_VALIDATION_PIPELINE_STATE_CREATE_FLAG_NONE.

Comentários

Aponte para um objeto usando essa estrutura com o membro pData de ID3D12DebugDevice1::SetDebugParameter para definir as configurações de validação de GPU-Based em todo o dispositivo.

Listas de comandos individuais podem substituir o modo de patch de sombreador padrão usando ID3D12DebugCommandList1::SetDebugParameter.