> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de PIXScopedEvent

> Referencia de PIXScopedEvent

# Referencia de PIXScopedEvent

Crea un evento definido por el usuario para una captura de tiempos de la actividad de la CPU, que se mostrará en la característica **Timing Capture** de Performance Investigator para XBOX (PIX).

<a id="syntaxSection" />

## Sintaxis

```cpp theme={null}
void PIXScopedEvent(
         UINT64 color,
         _In_ PCWSTR formatString,
         ...
)
```

<a id="parametersSection" />

### Parámetros

*color*   \
Tipo: UINT64

El color del evento que se usará en el gráfico de escala de tiempo. Especifique una constante [PIX\_COLOR](/reference/tools/pix3/functions/pix_color) para usar un color predefinido, una constante [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index) para usar un índice de color, o un valor DWORD en formato ARGB para usar un color personalizado. Si se especifica un valor DWORD con formato ARGB, el canal alfa de ese valor debe establecerse en `0xff`.

*formatString*   \_In\_\
Tipo: PCWSTR

El nombre que se usará para describir el evento, como puntero a una cadena Unicode terminada en null. La cadena puede especificar cero o más marcadores de posición de formato de cadena opcionales, de forma muy similar al formato de `sprintf`. Este método admite hasta 16 marcadores de posición.

Tipo: ...

Si se especifican marcadores de posición en *formatString*, debe especificar un número correspondiente de valores en este parámetro. Los tipos de los valores especificados en este parámetro dependen de los tipos identificados por sus marcadores de posición correspondientes.

<a id="retvalSection" />

### Valor devuelto

Tipo: void

<a id="remarksSection" />

## Comentarios

Esta función crea un evento definido por el usuario para una captura de tiempos de la actividad de la CPU, que se mostrará en la característica **Timing Capture** de PIX. Los eventos creados con `PIXScopedEvent` finalizan automáticamente cuando se sale del ámbito en el que se llama a la API, lo que hace que el emparejamiento del inicio y el final del evento sea automático.

La función `PIXScopedEvent` guarda la cadena de formato y los parámetros de formato en lugar de dar formato a la cadena en tiempo de ejecución. El formato se aplica después, al leer los archivos de captura en PIX. Use cadenas alineadas a 8 bytes o, preferiblemente, cadenas alineadas a 16 bytes con `PIXScopedEvent` para obtener el mejor rendimiento. Para dar formato a un `char\*` o `wchar_t\*` como puntero usando el especificador de formato `%p`, convierta el puntero a un `void\*` o a cualquier tipo entero o de punto flotante al pasar el puntero a `PIXScopedEvent`.

Las llamadas a `PIXScopedEvent` tienen garantizados al menos 512 bytes de espacio para guardar los datos del registro, lo que incluye el tamaño completo y la alineación de la cadena de formato y todas las variables. En general, los eventos de PIX están pensados para marcadores cortos de alto rendimiento que se alineen con los componentes, sistemas o contenido principales de su juego.

<a id="requirementsSection" />

## Requisitos

**Encabezado:** pix3.h

**Biblioteca:** pixevt.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

<a id="seealsoSection" />

## Consulte también

[PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent-overloads)\
[PIX3](/reference/tools/pix3/pix3_members)\
[PIX (tema NDA)](/tools/tools-console/pix/pix)


## Related topics

- [Referencia de la función PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent_3.md)
- [PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent-overloads.md)
- [Función PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent.md)
- [Información general de PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent_4.md)
- [Referencia de PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent_3.md)