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

# Referência de PIXSetMarker

> Referência de PIXSetMarker

# Referência de PIXSetMarker

Insere um marcador na linha do tempo da CPU na janela PIX System Timing Capture quando ocorre um determinado evento definido pelo usuário.

## Sintaxe

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

### Parâmetros

*color*   \
Tipo: UINT64

A cor que será usada no gráfico de tempo quando este evento ocorrer nas janelas do PIX.

Use [PIX\_COLOR](/pt-BR/reference/tools/pix3/functions/pix_color) para especificar uma cor, use [PIX\_COLOR\_INDEX](/pt-BR/reference/tools/pix3/functions/pix_color_index) 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: PCWSTR

O nome a ser usado para descrever o evento, como um ponteiro para uma cadeia de caracteres Unicode terminada em nulo. 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

A função `PIXSetMarker` salva a cadeia de caracteres de formato e os parâmetros de formato em vez de formatar a cadeia de caracteres em tempo de execução. A formatação é feita ao ler o arquivo de captura no PIX. Use cadeias de caracteres alinhadas a 16 bytes (preferível) ou alinhadas a 8 bytes com `PIXSetMarker` para obter o melhor desempenho. Para imprimir um char\* ou wchar\_t\* como ponteiro usando o especificador de formato %p, converta o ponteiro para void\* ou para um ponteiro de um tipo integral ou de ponto flutuante ao passá-lo para `PIXSetMarker`. Qualquer chamada a `PIXSetMarker` tem garantidos pelo menos 512 bytes de espaço para salvar os dados do registro.

O evento será mostrado sem duração e será representado por uma única linha (uma única barra vertical) na janela **PIX System Timing Capture**.

Esta função é usada para marcar eventos na linha do tempo da CPU. Para marcar eventos na linha do tempo da GPU, chame a [terceira sobrecarga da função PIXSetMarker](/pt-BR/reference/tools/pix3/functions/pixsetmarker_3) ou a [quarta sobrecarga da função PIXSetMarker](/pt-BR/reference/tools/pix3/functions/pixsetmarker_4)

As chamadas a `PIXSetMarker` podem ocorrer em qualquer lugar e não precisam vir depois de uma chamada a [PIXBeginEvent](/pt-BR/reference/tools/pix3/functions/pixbeginevent).

## Requisitos

**Cabeçalho:** pix3.h

**Biblioteca:** pixevt.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do PIX (tópico sob NDA)](/pt-BR/tools/tools-console/pix/pix)\
[pix3](/pt-BR/reference/tools/pix3/pix3_members)\
[PIXSetMarker](/pt-BR/reference/tools/pix3/functions/pixsetmarker)\
[PIXSetMarker\_3](/pt-BR/reference/tools/pix3/functions/pixsetmarker_3)\
[PIXSetMarker\_4](/pt-BR/reference/tools/pix3/functions/pixsetmarker_4)


## Related topics

- [Referencia de PIXSetMarker](/es/reference/tools/pix3/functions/pixsetmarker_2.md)
- [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)