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

> Referencia de la función PIXSetMarker

# Referencia de la función PIXSetMarker

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

## Sintaxis

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

### Parámetros

*context*   \
Tipo: void\*

Contexto del evento; acepta 1ID3D12GraphicsCommandList\*`,`ID3D12CommandQueue\*`e`ID3D12XboxDmaCommandList\*\` (solo XBOX).

*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 GPU. Para marcar eventos en la escala de tiempo de la CPU, llame a la [primera sobrecarga de la función PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker) o a la [segunda sobrecarga de la función PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker_2).

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](/reference/tools/pix3/functions/pixsetmarker)\
[PIXSetMarker\_2](/reference/tools/pix3/functions/pixsetmarker_2)\
[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 PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_2.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 la función PIXScopedEvent](/es/reference/tools/pix3/functions/pixscopedevent_3.md)
- [Referencia de la función PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent_2.md)