Cómo: Limitar la instrumentación a funciones específicas

Actualización: noviembre 2007

Puede limitar la instrumentación y la recolección de datos a una o más funciones; para ello, deberá establecer determinadas opciones en la página Avanzadas de la Sesión de rendimiento o en las páginas de propiedades del binario de destino.

• Si especifica las funciones en la página de propiedades de la sesión de rendimiento, sólo se instrumentan esas funciones en todos los binarios instrumentados de la sesión.

• Si especifica las funciones en la página de propiedades de un binario de destino, se instrumentan sólo las funciones que estén en ese binario determinado. Las funciones en otros binarios del rendimiento se instrumentan de la forma habitual.

La limitación de la recolección de datos de esta forma sólo se admite cuando se selecciona el método de generación de perfiles de instrumentación.

Nota:
También puede utilizar la página Avanzadas de las páginas de propiedades de Sesión de rendimiento a fin de establecer otras opciones disponibles para la herramienta de instrumentación de la línea de comandos VSInstr de Herramientas de generación de perfiles.

Para limitar la instrumentación a funciones específicas de una sesión de rendimiento

1. En el Explorador de rendimiento, haga clic con el botón secundario del mouse en el nombre de la sesión y, a continuación, haga clic en Propiedades.

   Aparecerá el cuadro de diálogo Páginas de propiedades.

2. En el cuadro de diálogo Páginas de propiedades, haga clic en Avanzadas.

3. En el cuadro de texto Opciones de instrumentación adicionales, utilice la siguiente sintaxis para escribir el nombre de las funciones que desea instrumentar:

   /include FuncSpec**[;FuncSpec]**...

   FuncSpec es el espacio de nombres y el nombre de la función. Tiene el formato Namespace**::**FunctionName. Utilice punto y coma para separar varias funciones. Utilice un asterisco (*) para especificar un carácter comodín para uno o más caracteres. Por ejemplo, /include MyNS::* especifica todas las funciones del espacio de nombres MyNS.

   Nota:
   Para enumerar las funciones de un binario, abra una ventana del símbolo del sistema en el directorio de instalación de Herramientas de generación de perfiles (normalmente el directorio \Team Tools\Performance Tools bajo el directorio de instalación de Visual Studio Team System) y, a continuación, escriba vsinstr /DumpFuncs.

Para limitar la instrumentación a funciones específicas de un binario

1. En Explorador de rendimiento, busque el nombre del binario en el nodo Destinos de la sesión de rendimiento.

2. Haga clic con el botón secundario del mouse en el nombre del binario y, a continuación, haga clic en Propiedades.

   Aparecerá el cuadro de diálogo Páginas de propiedades.

3. En el cuadro de diálogo Páginas de propiedades, haga clic en Avanzadas.

4. En el cuadro de texto Opciones de instrumentación adicionales, utilice la siguiente sintaxis para escribir el nombre de las funciones que desea instrumentar:

   /include FuncSpec**[;FuncSpec]**...

   FuncSpec es el espacio de nombres y el nombre de la función. Tiene el formato Namespace**::**FunctionName. Utilice punto y coma para separar varias funciones. Utilice un asterisco (*) para especificar un carácter comodín para uno o más caracteres. Por ejemplo, /include MyNS::* especifica todas las funciones del espacio de nombres MyNS.

   Nota:
   Para enumerar las funciones de un binario, abra una ventana del símbolo del sistema en el directorio de instalación de Herramientas de generación de perfiles (normalmente el directorio \Team Tools\Performance Tools bajo el directorio de instalación de Visual Studio Team System) y, a continuación, escriba vsinstr /DumpFuncs.

Vea también

Tareas

Cómo: Limitar la instrumentación a archivos DLL específicos

Cómo: Especificar opciones de instrumentación adicional

Otros recursos

Controlar la recolección de datos