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

> Referencia de PIXSetMarker

# Referencia de 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,  
         PCWSTR 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: 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`.

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

[Información general de PIX (tema NDA)](/tools/tools-console/pix/pix)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker)\
[PIXSetMarker\_3](/reference/tools/pix3/functions/pixsetmarker_3)\
[PIXSetMarker\_4](/reference/tools/pix3/functions/pixsetmarker_4)


## Related topics

- [Referencia de la función PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_3.md)
- [PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [Función PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker.md)
- [Información general de PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_4.md)
- [Referencia de TrySetLampArrayWorkerThreadAffinityMask](/es/reference/lighting/lamparray/functions/trysetlamparrayworkerthreadaffinitymask.md)