> ## 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 la función PIXScopedEvent

> Referencia de la función PIXScopedEvent

# Referencia de la función PIXScopedEvent

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

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*context*   \
Tipo: void\*

El contexto del evento. Solo para XBOX, este parámetro también acepta punteros `ID3D12GraphicsCommandList*`, `ID3D12GraphicsCommandList*` e `ID3D12XboxDmaCommandList*`, para permitir capturas de tiempos de la actividad de la GPU.

*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: PCSTR

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

Ninguno.

<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.

Este método se usa normalmente para medir el tiempo de los eventos de CPU. Sin embargo, pasar un puntero `ID3D12GraphicsCommandList*`, `ID3D12CommandQueue*` o `ID3D12XboxDmaCommandList*` en el parámetro `context` permite medir también el tiempo de los eventos de GPU.

<a id="remarksSection" />

## 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 PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent_2.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 la función PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent_2.md)
- [Referencia de la función PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_3.md)