Capturar información de gráficos

Puede capturar información de gráficos para utilizarla con las herramientas de Diagnóstico de gráficos de Visual Studio para diagnosticar problemas de representación en aplicaciones basadas en DirectX.

Puede capturar información de gráficos manualmente o mediante programación.Para capturar manualmente, ejecute la aplicación desde Visual Studio y elija el botón Capturar fotograma.Para capturar mediante programación, utilice la API de captura, que se incluye en Visual Studio, en el código fuente de la aplicación para especificar cuándo deben capturarse los fotogramas.

También puede evitar que se capture información de gráficos de la aplicación.

Capturar información de gráficos manualmente

Use el botón Capturar fotograma en la barra de herramientas de diagnósticos de gráficos para capturar manualmente un fotograma de información de gráficos desde una aplicación Direct3D en ejecución.Para capturar varios fotogramas, elija el botón varias veces.Antes de poder obtener los cuadros manualmente, tiene que iniciar la aplicación desde Visual Studio y haber habilitado el diagnóstico de gráficos.

Visual Studio utiliza la información capturada para volver a crear los fotogramas capturados más adelante y poder utilizar las herramientas de diagnóstico de gráficos para examinarlos en detalle.

Para iniciar una aplicación con el motor de diagnóstico de gráficos habilitado

• En la barra de menú, elija Depurar, Gráficos, Iniciar diagnóstico.(Teclado: presione Alt+F5)

Después de el diagnóstico de gráficos enlaza una aplicación, puede capturar la información de gráficos para tantos cuadros como desee.Cada vez que se inicia una captura, los eventos de Direct3D que aparecen durante el siguiente marco se registran junto con los objetos de Direct3D y los recursos que los respaldan.La grabación comienza inmediatamente después de presentar el fotograma actual y termina al presentar el fotograma que se desea capturar.

Para capturar un fotograma de información de gráficos

• En la barra de herramientas Diagnóstico de gráficos, elija el botón Capturar marco. (Teclado: con la aplicación en el foco, presione Impr Pant)

Cuando se captura el primer fotograma, Visual Studio crea un registro de gráficos para contener la información.Los cuadros capturados adicionales se agregan a este registro.Si cierra el documento en Visual Studio mientras se ejecuta la aplicación, el registro de gráficos (.vsglog) no puede capturar más marcos de información de gráficos, pero puede continuar depurándola mediante el depurador de Visual Studio.Para capturar más información de gráficos, detenga la depuración de la aplicación y utilice el comando Iniciar diagnóstico para volver a iniciar la aplicación.

Capturar información de gráficos mediante programación

Algunas veces, no es práctico o es imposible confiar en la captura manual para obtener información sobre un problema de representación que se intenta resolver.Por ejemplo, algunos tipos de problemas pueden ser demasiado intermitentes ser reproducidos manualmente, pero el programa condiciona esto porque podría ser sabido; o quizás tenga que recopilar información de los gráficos en un sistema que no admite captura manual porque no admite Visual Studio, como en el caso de los dispositivos de Windows RT.Para estos escenarios, Visual Studio incluye una API que se puede llamar mediante programación para capturar información de gráficos para un registro.Después de que el programa haya terminado de ejecutarse, puede abrir el registro de gráficos en Visual Studio para investigar los problemas que se grabaron.

Para obtener información sobre cómo habilitar una captura de programación en la aplicación y cómo configurar el equipo que la ejecutará para admitir capturas mediante programación, vea Tutorial: Capturar información de gráficos mediante programación.

Evitar la captura de información de gráficos

Antes de publicar la aplicación, puede deshabilitar el diagnóstico de gráficos y otras herramientas de generación de perfiles para evitar que los usuarios detecten cómo la aplicación usa la API de Direct3D.Esta información se podría utilizar de forma ilícita.Para obtener más información, vea Cómo: Deshabilitar los diagnósticos de gráficos en la aplicación.

Documentos del registro gráficos

Los documentos del registro de gráficos almacenan información sobre gráficos que se recopila durante una sesión de captura de diagnósticos de gráficos.Una sesión de captura puede ser iniciada manualmente o mediante programación.Los registros de gráficos contienen uno o más marcos que se capturaron EN una aplicación en ejecución de gráficos de DirectX.Para cada marco capturado, se registra una lista de cada evento de Direct3D que se produjo durante el marco.Esto incluye admitir los eventos de Direct3D que se produjeron anteriormente, como la creación del dispositivo de gráficos y admitir sombreadores, modelos, texturas y otros recursos gráficos.Dado que cada registro de gráficos es autónomo, estos marcos se pueden volver a crear, en cualquier momento, paso a paso y sin información o referencias externas.Puede compartir los registros de gráficos y examinar problemas en un equipo distinto del utilizado para capturar los datos o desarrollar el código.También, puede examinar los antiguos registros de gráficos incluso cuando los modelos y las texturas se han cambiado en el desarrollo.Cuando utilice el motor de diagnóstico de gráficos para diagnosticar problemas de gráficos, puede examinar cualquier llamada API de Direct3D y su estado asociado, los vértices individuales de los búferes, e incluso cómo resultan afectados los píxeles individuales por las llamadas a draw.

[!NOTA]

Aunque un registro de gráficos captura la mayoría de la información pertinente internamente, se requiere información adicional para usar plenamente algunas de las características del diagnóstico de gráficos.Por ejemplo, para usar plenamente la característica de la pila de llamada a gráficos, también debe tener el archivo de base de datos de programa (.pdb) y el código fuente de la aplicación, y depurar el código fuente del sombreador de HLSL, también debe tener el código fuente del sombreador (si el sombreador se compila con el compilador de sombreadores D3D11.1 y la información de depuración está habilitada, el código fuente del sombreador se insertará en el registro de gráficos durante la captura).

[!NOTA]

Puede extraer, modificar y guardar copias de mallas y texturas de registro de gráficos mediante las herramientas de gráficos que forman parte de Visual Studio.Sin embargo, el contenido del registro de los gráficos no se ven afectado por estas modificaciones.Para obtener información sobre estas herramientas de gráficos, vea Trabajar con activos 3D para juegos y aplicaciones.

Vea también

Tareas

Cómo: Deshabilitar los diagnósticos de gráficos en la aplicación

Tutorial: Capturar información de gráficos manualmente

Tutorial: Capturar información de gráficos mediante programación