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

> Função PIXSetRetailMarker

# Função PIXSetRetailMarker

Insere um marcador de varejo quando ocorre um determinado evento definido pelo usuário.

## Sintaxe

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

### Parâmetros

*context*   \
Tipo: void\*

Contexto do evento; aceita 1ID3D12GraphicsCommandList\*`,`ID3D12CommandQueue\*`e`ID3D12XboxDmaCommandList\*\` (somente XBOX).

*color*   \
Tipo: UINT64

A cor que será usada no gráfico de tempo quando este evento ocorrer nas janelas do PIX.\
Use [PIX\_COLOR](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/pix_color.md) para especificar uma cor, use [PIX\_COLOR\_INDEX](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/pix_color_index.md) para especificar um índice de cor ou passe um DWORD bruto, observando que o formato é ARGB e que o valor do canal alfa deve ser 0xff.

*formatString*   \_In\_\
Tipo: PCSTR

O nome a ser usado para descrever o evento. A cadeia de caracteres pode especificar zero ou mais espaços reservados de formato de cadeia de caracteres opcionais, muito semelhantes à formatação de **sprintf**.

Tipo: ...

Se espaços reservados forem usados em *formatString*, deverá haver um número correspondente de parâmetros (até um máximo de 16) cujos tipos correspondam aos espaços reservados.

### Valor retornado

Tipo: void

## Comentários

Com um dispositivo de depuração ou instrumentado, `PIXSetRetailMarker` se comporta de forma idêntica a [PIXSetMarker](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/pixsetmarker.md). Para um dispositivo de varejo, os marcadores serão incluídos em arquivos HIX para a depuração de travamentos da GPU.

As chamadas a `PIXSetRetailMarker` podem ocorrer em qualquer lugar e não precisam vir depois de uma chamada a [PIXBeginRetailEvent](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/pixbeginretailevent.md).

## Requisitos

**Cabeçalho:** pix3.h

**Biblioteca:** pixevt.lib
**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[PIXSetRetailMarker(void\*, UINT64, PCWSTR, ...)](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/pixsetretailmarker_2.md)\
[pix3](https://docs.xbox.com/pt-BR/reference/tools/pix3/pix3_members.md)\
[PIX (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/pix/pix.md)


## Related topics

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