> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EnqueueRequest

> IDStorageQueueX::EnqueueRequest

# IDStorageQueueX::EnqueueRequest

Enfileira uma solicitação de leitura.

## Sintaxe

```cpp theme={null}
void EnqueueRequest(  
         const DSTORAGE_REQUEST *request  
)  
```

### Parâmetros

*request*\
Tipo: [DSTORAGE\_REQUEST](https://docs.xbox.com/pt-BR/reference/system/dstorage/structs/dstorage_request.md)

A solicitação de leitura a ser enfileirada.

### Valor retornado

Tipo: void

## Comentários

Esse método enfileira os dados de *request*. A estrutura
[DSTORAGE\_REQUEST](https://docs.xbox.com/pt-BR/reference/system/dstorage/structs/dstorage_request.md) pode ser reutilizada assim que o
método retornar.

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

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](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md) manualmente
quando apropriado.

Para obter mais informações, consulte a seção "EnqueueRequest" de [Visão geral do
DirectStorage](https://docs.xbox.com/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md).

## Requisitos

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

**Biblioteca:** dstorage\_xs.lib

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

## Confira também

[IDStorageQueueX](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)\
[DStorage](https://docs.xbox.com/pt-BR/reference/system/dstorage/dstorage_members.md)


## Related topics

- [Visão geral do DirectStorage](https://docs.xbox.com/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md)
- [DSTORAGE_REQUEST](https://docs.xbox.com/pt-BR/reference/system/dstorage/structs/dstorage_request.md)
- [DSTORAGE_REQUEST_OPTIONS](https://docs.xbox.com/pt-BR/reference/system/dstorage/structs/dstorage_request_options.md)
- [Submit](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)