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

# PIXBeginRetailEvent

> PIXBeginRetailEvent

# PIXBeginRetailEvent

Inicia un evento comercial definido por el usuario.

## Sintaxis

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

### Parámetros

*context*   \
Tipo: void\*

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

*color*   \
Tipo: UINT64

El color del evento que se usará en el gráfico de tiempos del sistema. Use [PIX\_COLOR](/reference/tools/pix3/functions/pix_color) para especificar un color, [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 cuyos tipos dependen de los marcadores de posición. Este método admite hasta un máximo de 16 parámetros de formato.

### Valor devuelto

Tipo: void

## Comentarios

Con un dispositivo de depuración o instrumentado, `PIXBeginRetailEvent` se comporta de forma idéntica a [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent). En un dispositivo comercial, los eventos se incluirán en los archivos HIX para la depuración de bloqueos de GPU.

Los pares de `PIXBeginRetailEvent` y `PIXEndRetailEvent` se pueden anidar a cualquier profundidad.

## Requisitos

**Encabezado:** pix3.h

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

## Consulte también

[PIX (tema NDA)](/tools/tools-console/pix/pix)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIXEndRetailEvent](/reference/tools/pix3/functions/pixendretailevent)\
[PIXBeginRetailEvent(void\*, UINT64, PCSTR, ...)](/reference/tools/pix3/functions/pixbeginretailevent)


## Related topics

- [Función PIXBeginRetailEvent](/es/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXEndRetailEvent](/es/reference/tools/pix3/functions/pixendretailevent.md)
- [Función PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent-overloads.md)
- [PIXSetRetailMarker](/es/reference/tools/pix3/functions/pixsetretailmarker_2.md)
- [Función PIXSetRetailMarker](/es/reference/tools/pix3/functions/pixsetretailmarker.md)