XAsyncOp

Représente un code d’opération pour un fournisseur asynchrone.

Syntaxe

enum class XAsyncOp  : uint32_t  
{  
    Begin,  
    DoWork,  
    GetResult,  
    Cancel,  
    Cleanup  
}  

Constantes

Constante	Description
Begin	Le fournisseur asynchrone est appelé avec ce code d’opération lorsque XAsyncBegin est appelé. Si ce code d’opération est implémenté, le fournisseur asynchrone doit démarrer son travail asynchrone, soit en appelant XAsyncSchedule, soit en démarrant un processus asynchrone externe, comme une E/S avec chevauchement. REMARQUE Le travail asynchrone effectué pour ce code d’opération ne doit pas bloquer le thread.
DoWork	Le fournisseur asynchrone est appelé avec ce code d’opération lorsque XAsyncSchedule a été appelé pour planifier du travail. Si ce code d’opération est implémenté, le fournisseur asynchrone doit effectuer son travail asynchrone, puis appeler XAsyncComplete en spécifiant la taille de la charge utile de données dans requiredBufferSize. Si du travail supplémentaire doit être effectué, le fournisseur asynchrone peut le planifier, puis appeler `XAsyncComplete` en spécifiant le code d’erreur E_PENDING dans result.
GetResult	Le fournisseur asynchrone est appelé avec ce code d’opération après la fin d’un appel asynchrone, lorsque l’utilisateur doit obtenir la charge utile de données résultante. Les valeurs des champs buffer et bufferSize de XAsyncProviderData ont été validées.
Cancel	Le fournisseur asynchrone est appelé avec ce code d’opération lorsque le travail asynchrone doit être annulé. Le fournisseur asynchrone doit annuler tout le travail asynchrone, puis appeler XAsyncComplete en spécifiant le code d’erreur E_ABORT dans result.
Cleanup	Le fournisseur asynchrone est appelé avec ce code d’opération lorsque l’appel asynchrone est terminé ou annulé et que les données du contexte peuvent être nettoyées.

Remarques

La fonction de rappel XAsyncProvider d’un fournisseur asynchrone est appelée à plusieurs reprises, et ce que ce fournisseur asynchrone doit faire à chaque appel est déterminé par le code d’opération spécifié pour cet appel. XAsyncOp représente les codes d’opération qui peuvent être implémentés par un fournisseur asynchrone.
Un fournisseur asynchrone ne doit implémenter que les codes d’opération de XAsyncOp nécessaires pour effectuer le travail asynchrone. Par exemple, un fournisseur asynchrone qui effectue un travail d’E/S asynchrone non annulable ne nécessitant aucun nettoyage n’a besoin d’implémenter que XAsyncOp::GetResult. Pour un exemple de fournisseur asynchrone qui implémente les codes d’opération DoWork, GetResult et Cleanup de XAsyncOp, consultez la section « Bibliothèque asynchrone » dans Modèle de programmation asynchrone.

Configuration requise

En-tête : XAsyncProvider.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XAsyncProviderData
Membres XAsyncProvider
Modèle de programmation asynchrone

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XAsyncOp

XAsyncOp

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi

​XAsyncOp

​Syntaxe

​Constantes

​Remarques

​Configuration requise

​Voir aussi

XAsyncOp

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi