Método ID3D11ShaderTrace::TraceReady (d3d11shadertracing.h)

Especifica que o rastreamento de sombreador foi registrado e está pronto para uso.

Sintaxe

HRESULT TraceReady(
  [out, optional] UINT64 *pTestCount
);

Parâmetros

[out, optional] pTestCount

Um ponteiro opcional para uma variável que recebe o número de vezes que ocorreu uma invocação correspondente para o rastreamento. Se não for usado, defina como NULL. Para obter mais informações sobre esse número, consulte Comentários.

Retornar valor

TraceReady retorna:

• S_OK se o rastreamento estiver pronto.
• S_FALSE se o rastreamento não estiver pronto.
• E_OUTOFMEMORY se a memória acabou enquanto o rastreamento estava em processo de gravação. Você pode tentar registrar o rastreamento novamente chamando ID3D11ShaderTrace::ResetTrace e redesenhando. Se você decidir não gravar o rastreamento novamente, libere a interface ID3D11ShaderTrace .
• Possivelmente outros códigos de erro descritos em Códigos de Retorno do Direct3D 11.

Comentários

Se um rastreamento deve registrar a invocação 3, mas apenas duas invocações ocorreram até agora, TraceReady define a variável para a qual pTestCount aponta para 2. Você pode usar esse valor para entender por que um rastreamento ainda não está pronto. Por outro lado, a variável para a qual pTestCount aponta pode ser maior do que a contagem de invocação solicitada para um rastreamento que está pronto. Você pode usar esse valor para determinar o número de invocações executadas após a contagem de invocação de rastreamento necessária. Por exemplo, talvez você não saiba o número de overdraws que ocorrem em um pixel para um determinado sombreador em uma chamada de desenho. Se você puder redesenhar a cena de forma idêntica, poderá configurar os rastreamentos na próxima vez com base no valor que TraceReady retornou em pTestCount na primeira passagem.

Se o rastreamento do sombreador for registrado, você poderá chamar com êxito os métodos ID3D11ShaderTrace::GetTraceStats, ID3D11ShaderTrace::GetInitialRegisterContents e ID3D11ShaderTrace::GetStep . Você pode chamar os métodos ID3D11ShaderTrace::ResetTrace e ID3D11ShaderTrace::P SSelectStamp , independentemente de o rastreamento do sombreador ter sido registrado.

Requisitos

Confira também

ID3D11ShaderTrace