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

> IDStorageQueueX::EnqueueStatus

# IDStorageQueueX::EnqueueStatus

Met en file d'attente une écriture d'état.

## Syntaxe

```cpp theme={null}
void EnqueueStatus(  
         IDStorageStatusArrayX *statusArray,  
         UINT32 index  
)  
```

### Paramètres

*statusArray*\
Type : IDStorageStatusArrayX

Un objet [IDStorageStatusArrayX](/fr-CA/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx).

*index*\
Type : UINT32

Index de l'entrée d'état, dans l'objet `IDStorageStatusArrayX`, qui doit recevoir l'état.

### Valeur de retour

Type : void

## Remarques

Le tableau d'états est signalé lorsque toutes les requêtes mises en file d'attente avant lui sont terminées.

Après l'appel de cette méthode, un thread du titre peut interroger l'objet `IDStorageStatusArrayX`
au besoin. (L'état de l'entrée est indéfini tant que cette méthode n'a pas été
appelée.) Si des échecs se sont produits depuis l'entrée d'état précédente, le champ *HResult*
de l'entrée d'état mise en file d'attente stocke le code d'échec de la première requête
ayant échoué.

Si la méthode `EnqueueStatus` 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
`EnqueueStatus`.

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

Si la soumission automatique n'est pas souhaitable, il est recommandé aux jeux d'utiliser une file d'attente
d'une 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 les sections « Notification » et
« EnqueueStatus/EnqueueSignal/EnqueueSetEvent » 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

[IDStorageFactoryX::CreateStatusArray](/fr-CA/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createstatusarray)\
[IDStorageQueueX::EnqueueSignal](/fr-CA/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal)\
[IDStorageQueueX](/fr-CA/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/fr-CA/reference/system/dstorage/dstorage_members)


## Related topics

- [IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageQueueX::EnqueueSignal](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)