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

# IDStorageQueueX::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](/pt-BR/reference/system/dstorage/structs/dstorage_request)

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](/pt-BR/reference/system/dstorage/structs/dstorage_request) 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](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit) manualmente
quando apropriado.

Para obter mais informações, consulte a seção "EnqueueRequest" de [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](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/pt-BR/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_REQUEST_OPTIONS](/pt-BR/reference/system/dstorage/structs/dstorage_request_options.md)
- [DSTORAGE_REQUEST](/pt-BR/reference/system/dstorage/structs/dstorage_request.md)
- [IDStorageQueueX::EnqueueSignal](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)
- [IDStorageQueueX::EnqueueStatus](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageQueueX::CancelRequestsWithTag](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_cancelrequestswithtag.md)