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

Este tutorial muestra cómo utilizar las herramientas de diagnóstico de gráficos de Visual Studio para capturar mediante programación la información de gráficos de una aplicación Direct3D.

Este tutorial muestra estas tareas:

• Preparar el equipo para usar la captura mediante programación.

• Preparar la aplicación para usar la captura mediante programación.

• Configurar el nombre y la ubicación del archivo de registro de gráficos.

• Usar la API de CaptureCurrentFrame.

Preparar el equipo para usar la captura mediante programación

La captura de API mediante programación utiliza herramientas remotas para que Visual Studio proporcione funcionalidad de captura.El equipo donde se ejecutará la aplicación debe tener las herramientas remotas instaladas, incluso cuando se utiliza captura mediante programación en el equipo local.No es necesario que Visual Studio se esté ejecutando al realizar la captura mediante programación en un equipo local.

Para utilizar las API de captura remota en una aplicación que se está ejecutando en un equipo, primero tiene que instalar las Herramientas remotas para Visual Studio en ese equipo.Versiones diferentes de herramientas remotas admiten distintas plataformas de hardware.Para obtener información sobre cómo instalar las herramientas remotas, vea Página de descarga de herramientas remotas en el sitio web de descargas de Microsoft.

Alternativamente, Visual Studio instala los componentes necesarios para realizar la captura remota para aplicaciones de 32 bits.

[!NOTA]

Como la mayoría de las aplicaciones de escritorio de Windows, incluidas Visual Studio, no se admiten en Windows 8 para dispositivos de ARM, el uso de herramientas remotas para Visual Studio junto con la captura de API mediante programación es la única forma de obtener diagnósticos de gráficos en dispositivos de ARM.

Preparar la aplicación para usar la captura mediante programación

Para utilizar las herramientas de diagnóstico de gráficos, primero tiene que capturar la información de gráficos en la que se basan.Puede capturar información mediante programación utilizando la API de CaptureCurrentFrame.

Para preparar la aplicación para capturar información de gráficos mediante programación

1. Asegúrese de que el encabezado de vsgcapture.h esté incluido en el código fuente de la aplicación.Se puede incluir en una sola ubicación, por ejemplo, en el archivo de código fuente donde llamará a la API de captura mediante programación o en un archivo de encabezado precompilado para llamar a la API desde varios archivos de código fuente.

2. En el código fuente de la aplicación, siempre que desee capturar el resto del fotograma actual, llame a g_pVsgDbg->CaptureCurrentFrame().Este método no toma ningún parámetro y no devuelve ningún valor.

Configurar el nombre y la ubicación del archivo de registro de gráficos

El registro de gráficos se crea en la ubicación definida por las macros DONT_SAVE_VSGLOG_TO_TEMP y VSG_DEFAULT_RUN_FILENAME.

Para configurar el nombre y la ubicación del archivo de registro de gráficos

• Para evitar que el registro de gráficos se escriba en el directorio Temp, antes de la línea de #include <vsgcapture.h>, agregue esto:

  #define DONT_SAVE_VSGLOG_TO_TEMP
  

  Puede definir este valor para escribir el registro de gráficos en una ubicación relativa al directorio de trabajo, o en una ruta de acceso absoluta si la definición de VSG_DEFAULT_RUN_FILENAME es una ruta de acceso absoluta.

• Para guardar el registro de gráficos en una ubicación diferente o asignarle un nombre de archivo diferente, antes de la línea #include <vsgcapture.h>, agregue esto:

  #define VSG_DEFAULT_RUN_FILENAME <filename>
  

  Si no realiza este paso, el nombre de archivo es default.vsglog.Si no se definió DONT_SAVE_VSGLOG_TO_TEMP, la ubicación del archivo es relativa al directorio Temp; de lo contrario, es relativa al directorio de trabajo o a otra ubicación si especificó un nombre de archivo absoluto.

Para las aplicaciones de Tienda Windows , la ubicación del directorio Temp es específica de cada usuario y aplicación, y se encuentra normalmente en una ubicación como C:\users\nombre de usuario\AppData\Local\Packages \apellido de paquete\TempState \.Para las aplicaciones de escritorio, la ubicación del directorio Temp es específica de cada usuario y se encuentra normalmente en una ubicación como C:\Users\nombre de usuarioAppData\Local\Temp\.

[!NOTA]

Para escribir en una ubicación concreta, debe tener permisos para escribir en esa ubicación; si no, se produce un error.Tenga en cuenta que las aplicaciones de Tienda Windows están limitadas a aplicaciones de escritorio sobre las que pueden escribir datos y pueden requerir configuración adicional para escribir en algunas ubicaciones.

Capturar información de gráficos

Después de haber preparado la aplicación para la captura de programación y configurado opcionalmente la ubicación y el nombre del archivo de registro de gráficos, compile la aplicación y después ejecútela o depúrela para capturar datos; no inicie los diagnósticos de gráficos desde Visual Studio al usar la API de captura de programación.El registro de gráficos se escribe en la ubicación que especificó.Si desea conservar esta versión del registro, muévalo a otra ubicación; si no, se sobrescribirá cuando vuelva a ejecutar la aplicación.

Sugerencia
Puede seguir capturando información de gráficos manualmente mientras utiliza la captura mediante programación presionando Impr Pant con el foco en la aplicación.Puede utilizar esto para capturar información adicional de gráficos que no se captura mediante el uso de la API de captura de programación.

Pasos siguientes

Este tutorial mostró cómo capturar información gráficos mediante programación.Como paso siguiente, considere esta opción:

• Aprenda a analizar la información de capturada de gráficos mediante las herramientas de diagnóstico de gráficos.Vea Diagnóstico de gráficos.

Vea también

Tareas

Tutorial: Capturar información de gráficos manualmente

Conceptos

Capturar información de gráficos