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

# PIXSetRetailMarker(void*, UINT64, PCSTR, ...)

> Función PIXSetRetailMarker

# Función PIXSetRetailMarker

Inserta un marcador comercial, cuando se produce un evento determinado definido por el usuario.

## Sintaxis

```cpp theme={null}
void PIXSetRetailMarker(  
         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](https://docs.xbox.com/es/reference/tools/pix3/functions/pix_color.md) para especificar un color, use [PIX\_COLOR\_INDEX](https://docs.xbox.com/es/reference/tools/pix3/functions/pix_color_index.md) 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

Con un dispositivo de depuración o instrumentado, `PIXSetRetailMarker` se comporta de forma idéntica a [PIXSetMarker](https://docs.xbox.com/es/reference/tools/pix3/functions/pixsetmarker.md). En un dispositivo comercial, los marcadores se incluirán en los archivos HIX para la depuración de bloqueos de GPU.

Las llamadas a `PIXSetRetailMarker` pueden producirse en cualquier lugar y no tienen que seguir a una llamada a [PIXBeginRetailEvent](https://docs.xbox.com/es/reference/tools/pix3/functions/pixbeginretailevent.md).

## Requisitos

**Encabezado:** pix3.h

**Biblioteca:** pixevt.lib
**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[PIXSetRetailMarker(void\*, UINT64, PCWSTR, ...)](https://docs.xbox.com/es/reference/tools/pix3/functions/pixsetretailmarker_2.md)\
[pix3](https://docs.xbox.com/es/reference/tools/pix3/pix3_members.md)\
[PIX (tema NDA)](https://docs.xbox.com/es/tools/tools-console/pix/pix.md)


## Related topics

- [PIXSetRetailMarker(void*, UINT64, PCWSTR, ...)](https://docs.xbox.com/es/reference/tools/pix3/functions/pixsetretailmarker_2.md)
- [PIXSetMarker](https://docs.xbox.com/es/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [PIXSetMarker(void*, UINT64, PCSTR, ...)](https://docs.xbox.com/es/reference/tools/pix3/functions/pixsetmarker_3.md)
- [PIXSetMarker(UINT64, PCSTR, ...)](https://docs.xbox.com/es/reference/tools/pix3/functions/pixsetmarker.md)
- [PIXBeginRetailEvent(void*, UINT64, PCSTR, ...)](https://docs.xbox.com/es/reference/tools/pix3/functions/pixbeginretailevent.md)