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

Met en file d'attente une requête de lecture.

## Syntaxe

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

### Paramètres

*request*\
Type : [DSTORAGE\_REQUEST](/fr-CA/reference/system/dstorage/structs/dstorage_request)

La requête de lecture à mettre en file d'attente.

### Valeur de retour

Type : void

## Remarques

Cette méthode met en file d'attente les données de *request*. La structure
[DSTORAGE\_REQUEST](/fr-CA/reference/system/dstorage/structs/dstorage_request) peut être réutilisée dès le retour
de la méthode.

Si la méthode `EnqueueRequest` remplit la moitié de la capacité de la file d'attente depuis la dernière
soumission, elle déclenche une soumission automatique dans le cadre de l'appel
`EnqueueRequest`.

Dans la plupart des cas, cette méthode effectue simplement une écriture en mémoire dans la file d'attente et nécessite donc
très peu de temps processeur. Toutefois, si une soumission automatique est déclenchée,
elle nécessite beaucoup plus de temps processeur, notamment pour une transition en mode noyau et le
traitement de toutes les requêtes précédemment soumises dans le thread appelant.

Si la soumission automatique n'est pas souhaitable, il est recommandé aux jeux d'utiliser une file d'attente
de capacité suffisante et d'appeler [Submit](/fr-CA/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit) manuellement
au moment opportun.

Pour plus d'informations, consultez la section « EnqueueRequest » de la [Vue d'ensemble
de DirectStorage](/fr-CA/build/console-features/storage/directstorage/directstorage-overview).

## Configuration requise

**En-tête :** dstorage\_xs.h

**Bibliothèque :** dstorage\_xs.lib

**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[IDStorageQueueX](/fr-CA/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/fr-CA/reference/system/dstorage/dstorage_members)


## Related topics

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