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

# Función PIXSetMarker

> Función PIXSetMarker

# Función PIXSetMarker

Inserta un marcador en la escala de tiempo de la CPU en la ventana PIX System Timing Capture, cuando se produce un evento determinado definido por el usuario.

## Sintaxis

```cpp theme={null}
void PIXSetMarker(  
         UINT64 color,  
         PCSTR formatString,  
         ...  
)  
```

### Parámetros

*color*   \
Tipo: UINT64

El color que se usará en el gráfico de tiempos cuando este evento se produzca en las ventanas de PIX.

Use [PIX\_COLOR](/reference/tools/pix3/functions/pix_color) para especificar un color, use [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index) para especificar un índice de color, o pase un DWORD sin procesar teniendo en cuenta que el formato es ARGB y el valor del canal alfa debe ser 0xff.

*formatString*   \_In\_\
Tipo: PCSTR

El nombre que se usará para describir el evento. 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`.

Tipo: ...

Si se usan marcadores de posición en *formatString*, debe haber un número correspondiente de parámetros (hasta un máximo de 16) cuyos tipos coincidan con los marcadores de posición.

### Valor devuelto

Tipo: void

## Comentarios

La función `PIXSetMarker` 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 el archivo de captura en PIX. Use cadenas alineadas a 16 bytes (preferible) o cadenas alineadas a 8 bytes con `PIXSetMarker` para obtener el mejor rendimiento. Para imprimir un char\* o wchar\_t\* como puntero usando el especificador de formato %p, convierta el puntero a void\* o a un puntero a un tipo entero o de punto flotante al pasarlo a `PIXSetMarker`. Cualquier llamada a `PIXSetMarker` tiene garantizados al menos 512 bytes de espacio para guardar los datos del registro.

El evento se mostrará sin duración, y estará representado por una sola línea (una única barra vertical) en la ventana **PIX System Timing Capture**.

Esta función se usa para marcar eventos en la escala de tiempo de la CPU. Para marcar eventos en la escala de tiempo de la GPU, llame a la [tercera sobrecarga de la función PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker_3) o a la [cuarta sobrecarga de la función PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker_4)

Las llamadas a `PIXSetMarker` pueden producirse en cualquier lugar y no tienen que seguir a una llamada a [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent).

## Requisitos

**Encabezado:** pix3.h

**Biblioteca:** pixevt.lib

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

## Consulte también

[PIXSetMarker\_2](/reference/tools/pix3/functions/pixsetmarker_2)\
[PIXSetMarker\_3](/reference/tools/pix3/functions/pixsetmarker_3)\
[PIXSetMarker\_4](/reference/tools/pix3/functions/pixsetmarker_4)\
[PIX3](/reference/tools/pix3/pix3_members)\
[PIX (tema NDA)](/tools/tools-console/pix/pix)


## Related topics

- [Referencia de la función PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_3.md)
- [Referencia de PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_2.md)
- [Información general de PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_4.md)
- [PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [Función PIXSetRetailMarker](/es/reference/tools/pix3/functions/pixsetretailmarker.md)