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

Especifica que el seguimiento del sombreador registrado y está listo para usarse.

Sintaxis

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

Parámetros

[out, optional] pTestCount

Puntero opcional a una variable que recibe el número de veces que se produjo una invocación coincidente para el seguimiento. Si no se usa, establezca en NULL. Para obtener más información sobre este número, vea Comentarios.

Valor devuelto

TraceReady devuelve:

• S_OK si el seguimiento está listo.
• S_FALSE si el seguimiento no está listo.
• E_OUTOFMEMORY si la memoria se agotó mientras el seguimiento estaba en proceso de grabación. Puede intentar volver a registrar el seguimiento llamando a ID3D11ShaderTrace::ResetTrace y vuelve a dibujar. Si decide no volver a registrar el seguimiento, libere la interfaz ID3D11ShaderTrace .
• Posiblemente otros códigos de error que se describen en Códigos de retorno de Direct3D 11.

Comentarios

Si un seguimiento está pensado para registrar la invocación 3, pero solo se han producido dos invocaciones hasta ahora, TraceReady establece la variable en la que pTestCount apunta a 2. Puede usar este valor para comprender por qué todavía no está listo un seguimiento. Por el contrario, la variable a la que apunta pTestCount puede ser mayor que el recuento de invocaciones solicitado para un seguimiento que esté listo. Puede usar este valor para determinar el número de invocaciones que se ejecutaron después del recuento de invocaciones de seguimiento necesarios. Por ejemplo, es posible que no conozca el número de sobredraws que se producen en un píxel para un sombreador determinado en una llamada de dibujo. Si puede volver a dibujar la escena de forma idéntica, puede configurar los seguimientos esta próxima vez en función del valor que TraceReady devolvió en pTestCount en el primer paso.

Si el seguimiento del sombreador registrado, puede llamar correctamente a los métodos ID3D11ShaderTrace::GetTraceStats, ID3D11ShaderTrace::GetInitialRegisterContents y ID3D11ShaderTrace::GetStep . Puede llamar a los métodos ID3D11ShaderTrace::ResetTrace e ID3D11ShaderTrace::P SSelectStamp independientemente de si el seguimiento del sombreador registrado.

Nota Esta API requiere el Kit de desarrollo de software (SDK) de Windows para Windows 8.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d3d11shadertracing.h
Archivo DLL	D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

Consulte también

ID3D11ShaderTrace