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

# IDStorageQueueX1::EnqueueSetEvent

> IDStorageQueueX1::EnqueueSetEvent

# IDStorageQueueX1::EnqueueSetEvent

Pone en cola una operación **SetEvent**.

## Sintaxis

```cpp theme={null}
void EnqueueSetEvent(  
         HANDLE handle  
)  
```

### Parámetros

*handle*\
Tipo: HANDLE

Identificador de evento.

### Valor devuelto

Tipo: void

## Comentarios

El evento especificado se señala cuando se completan todas las solicitudes puestas en cola antes que él.
El evento puede ser de restablecimiento automático o de restablecimiento manual.

Después de llamar a este método, un subproceso del título puede esperar por el evento según sea necesario. Si
el evento ya está en estado señalado cuando se produce la operación de establecimiento de evento, se
imprime un mensaje de advertencia en el depurador si DSTORAGE\_DEBUG\_SHOW\_ERRORS está
activado.

Si el método `EnqueueSetEvent` llena la mitad de la capacidad de la cola desde el
último envío, desencadena un envío automático como parte de la llamada a
`EnqueueSetEvent`.

En la mayoría de los casos, este método simplemente realiza una escritura en memoria en la cola y, por tanto, tarda
muy poco tiempo de CPU en completarse. Sin embargo, si se desencadena el envío automático,
consume bastante más tiempo de CPU, incluida una transición al modo kernel y
el procesamiento de todas las solicitudes enviadas anteriormente en el subproceso del autor de la llamada.

Si el envío automático no es deseable, se recomienda que los juegos usen una cola
con capacidad suficientemente grande y llamen a [Submit](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit) manualmente
cuando corresponda.

Para obtener más información, consulte las secciones "Notification" y
"EnqueueStatus/EnqueueSignal/EnqueueSetEvent" en [Información general de
DirectStorage](/build/console-features/storage/directstorage/directstorage-overview).

## Requisitos

**Encabezado:** dstorage\_xs.h

**Biblioteca:** dstorage\_xs.lib

**Plataformas compatibles:** consolas XBOX Series

## Consulte también

[IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus)\
[IDStorageQueueX::EnqueueSignal](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal)\
[IDStorageQueueX](/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/reference/system/dstorage/dstorage_members)


## Related topics

- [IDStorageQueueX1](/es/reference/system/dstorage/interfaces/IDStorageQueueX1/idstoragequeuex1.md)
- [Información general de DirectStorage](/es/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageQueueX::Submit](/es/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX2](/es/reference/system/dstorage/interfaces/IDStorageQueueX2/idstoragequeuex2.md)
- [IDStorageQueueX::EnqueueSignal](/es/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)