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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | d3d11shadertracing.h |
| DLL | D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll |