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

# SetEventOnCompletion

> Especifica un evento que debe desencadenarse cuando la barrera alcanza un determinado valor. (ID3D12Fence.SetEventOnCompletion)

Especifica un evento que se genera cuando la barrera alcanza un determinado valor.

## Sintaxis

```cpp theme={null}
HRESULT SetEventOnCompletion(
    UINT64 Value,
    HANDLE hEvent
)
```

### Parámetros

*Value*\
Tipo: UINT64

El valor de la barrera cuando se debe señalizar el evento.

*hEvent*\
Tipo: HANDLE

Un identificador del objeto de evento.

### Valor devuelto

Tipo: HRESULT

Este método devuelve **E\_OUTOFMEMORY** si los componentes del kernel no tienen memoria suficiente para almacenar el evento en una lista. Consulte [Códigos devueltos de Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues) para conocer otros valores devueltos posibles.

## Comentarios

Para especificar varias barreras antes de que se desencadene un evento, consulte [SetEventOnMultipleFenceCompletion](/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_seteventonmultiplefencecompletion_public).

Si *hEvent* es un identificador nulo, esta API no devolverá el control hasta que se hayan alcanzado los valores de barrera especificados.

Este método se puede llamar de forma segura desde varios subprocesos a la vez.

## Ejemplos

El ejemplo [D3D12Multithreading](https://learn.microsoft.com/en-us/windows/win32/direct3d12/working-samples) usa **ID3D12Fence::SetEventOnCompletion** de la siguiente manera:

```cpp theme={null}
// Wait for the command list to execute; we are reusing the same command
// list in our main loop but for now, we just want to wait for setup to
// complete before continuing.

// Signal and increment the fence value.
const UINT64 fenceToWaitFor = m_fenceValue;
ThrowIfFailed(m_commandQueue->Signal(m_fence.Get(), fenceToWaitFor));
m_fenceValue++;

// Wait until the fence is completed.
ThrowIfFailed(m_fence->SetEventOnCompletion(fenceToWaitFor, m_fenceEvent));
WaitForSingleObject(m_fenceEvent, INFINITE);
```

Consulte el [código de ejemplo en la referencia de Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/notes-on-example-code).

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

[ID3D12Fence](/reference/graphics/d3d12/interfaces/id3d12fence/id3d12fence_public)

[Sincronización de varios motores](https://learn.microsoft.com/en-us/windows/win32/direct3d12/user-mode-heap-synchronization)


## Related topics

- [SetEventOnMultipleFenceCompletion](/es/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_seteventonmultiplefencecompletion_public.md)
- [Información general de DirectStorage](/es/build/console-features/storage/directstorage/directstorage-overview.md)
- [GetDeviceRemovedReason](/es/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getdeviceremovedreason_public.md)
- [Wait](/es/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_wait_public.md)
- [EventExportCompletionStatus](/es/services/playfab/api-references/events/data-types/eventexportcompletionstatus.md)