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

# ID3D12GraphicsCommandList::BeginEvent

> No está pensado para llamarse directamente.  Use el runtime de eventos de PIX para insertar eventos en una lista de comandos. (ID3D12GraphicsCommandList.BeginEvent)

No está pensado para llamarse directamente.  Use el
[runtime de eventos de PIX](https://devblogs.microsoft.com/pix/winpixeventruntime/) para insertar eventos en una lista de comandos.

## Sintaxis

```cpp theme={null}
void BeginEvent(
    UINT Metadata,
    const void  pData,
    UINT Size
)
```

### Parámetros

*Metadata*\
Tipo: UINT

Interno.

*pData \[in, optional]*\
Tipo: const void \*

Interno.

*Size*\
Tipo: UINT

Interno.

### Valor devuelto

Tipo: void

Ninguno.

## Comentarios

Este es un método auxiliar que el runtime de eventos de PIX usa internamente.  No está pensado para llamarse directamente.

Para marcar el inicio de una región de instrumentación en la ubicación actual dentro de una lista de comandos de D3D12, use la función **PIXBeginEvent** o la macro **PIXScopedEvent**.  Estas se proporcionan en el paquete NuGet [WinPixEventRuntime](https://devblogs.microsoft.com/pix/winpixeventruntime/).

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[ID3D12GraphicsCommandList](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [PIXBeginRetailEvent](/es/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [Referencia de PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent_3.md)
- [Función PIXBeginRetailEvent](/es/reference/tools/pix3/functions/pixbeginretailevent.md)
- [BeginQuery](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_beginquery_public.md)
- [Información general de PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent_4.md)