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

Enfileira uma operação **SetEvent**.

## Sintaxe

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

### Parâmetros

*handle*\
Tipo: HANDLE

Um identificador de evento.

### Valor retornado

Tipo: void

## Comentários

O evento especificado é sinalizado quando todas as solicitações enfileiradas antes dele são concluídas.
O evento pode ser de redefinição automática ou de redefinição manual.

Depois de chamar este método, um thread do título pode aguardar o evento conforme necessário. Se
o evento já estiver no estado sinalizado quando a operação de definição de evento ocorrer, uma
mensagem de aviso será impressa no depurador se DSTORAGE\_DEBUG\_SHOW\_ERRORS estiver
ativado.

Se o método `EnqueueSetEvent` preencher metade da capacidade da fila desde o
último envio, ele disparará um envio automático como parte da chamada de
`EnqueueSetEvent`.

Na maioria dos casos, esse método simplesmente faz uma gravação de memória na fila e, portanto, leva
muito pouco tempo de CPU para ser concluído. No entanto, se o envio automático for disparado,
ele levará significativamente mais tempo de CPU, incluindo uma transição para o modo kernel e
o processamento de todas as solicitações enviadas anteriormente no thread chamador.

Se o envio automático não for desejável, é recomendável que os jogos usem uma fila
com capacidade grande o suficiente e chamem [Submit](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit) manualmente
quando apropriado.

Para obter mais informações, consulte as seções "Notification" e
"EnqueueStatus/EnqueueSignal/EnqueueSetEvent" em [Visão geral do
DirectStorage](/pt-BR/build/console-features/storage/directstorage/directstorage-overview).

## Requisitos

**Cabeçalho:** dstorage\_xs.h

**Biblioteca:** dstorage\_xs.lib

**Plataformas compatíveis:** consoles XBOX Series

## Confira também

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


## Related topics

- [IDStorageQueueX1](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX1/idstoragequeuex1.md)
- [Visão geral do DirectStorage](/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageQueueX::Submit](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX2](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX2/idstoragequeuex2.md)
- [IDStorageQueueX::EnqueueSignal](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)