IDStorageQueueX1::EnqueueSetEvent
Met en file d’attente une opération SetEvent.Syntaxe
Paramètres
handleType : HANDLE Un handle d’événement.
Valeur de retour
Type : voidRemarques
L’événement spécifié est signalé lorsque toutes les requêtes mises en file d’attente avant lui sont terminées. L’événement peut être à réinitialisation automatique ou à réinitialisation manuelle. Après l’appel de cette méthode, un thread du titre peut attendre l’événement au besoin. Si l’événement est déjà à l’état signalé lorsque l’opération de définition d’événement se produit, un message d’avertissement est affiché dans le débogueur si DSTORAGE_DEBUG_SHOW_ERRORS est activé. Si la méthodeEnqueueSetEvent 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
EnqueueSetEvent.
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
IDStorageQueueX::EnqueueStatusIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage