IDStorageQueueX::EnqueueStatus
Met en file d’attente une écriture d’état.Syntaxe
Paramètres
statusArrayType : IDStorageStatusArrayX Un objet IDStorageStatusArrayX. index
Type : UINT32 Index de l’entrée d’état, dans l’objet
IDStorageStatusArrayX, qui doit recevoir l’état.
Valeur de retour
Type : voidRemarques
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’objetIDStorageStatusArrayX
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 manuellement
au moment opportun.
Pour plus d’informations, consultez les sections « Notification » et
« EnqueueStatus/EnqueueSignal/EnqueueSetEvent » de la vue d’ensemble de
DirectStorage.
Configuration requise
En-tête : dstorage_xs.h Bibliothèque : dstorage_xs.lib Plateformes prises en charge : consoles XBOX SeriesVoir aussi
IDStorageFactoryX::CreateStatusArrayIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage