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

# ID3D12CommandQueue::BeginEvent

> No está pensado para llamarse directamente. Use el entorno de ejecución de eventos de PIX para insertar eventos en una cola de comandos. (ID3D12CommandQueue.BeginEvent)

No está pensado para llamarse directamente.  Use el
[entorno de ejecución de eventos de PIX](https://devblogs.microsoft.com/pix/winpixeventruntime/) para insertar eventos en una cola 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 de soporte que el entorno de ejecución 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 cola de comandos de D3D12, use la función **PIXBeginEvent** o la macro **PIXScopedEvent**.  Estas las proporciona 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

[ID3D12CommandQueue](/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)


## Related topics

- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [ID3D12CommandQueue::Signal](/es/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_signal_public.md)
- [ID3D12CommandQueue::GetDesc](/es/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_getdesc_public.md)
- [D3D12_COMMAND_QUEUE_DESC](/es/reference/graphics/d3d12/structs/d3d12_command_queue_desc_public.md)
- [CreateCommandQueue](/es/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandqueue_public.md)