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

# XAsyncRun

> XAsyncRun

# XAsyncRun

Exécute de manière asynchrone la fonction de rappel spécifiée.

## Syntaxe

```cpp theme={null}
HRESULT XAsyncRun(  
         XAsyncBlock* asyncBlock,  
         XAsyncWork* work  
)  
```

### Paramètres

*asyncBlock*   \_Inout\_\
Type : [XAsyncBlock\*](/fr-CA/reference/system/xasync/structs/xasyncblock)

Pointeur vers le [XAsyncBlock](/fr-CA/reference/system/xasync/structs/xasyncblock) utilisé pour suivre l'appel asynchrone.

*work*   \_In\_\
Type : [XAsyncWork\*](/fr-CA/reference/system/xasync/functions/xasyncwork)

Pointeur vers une fonction de rappel à exécuter de manière asynchrone.

### Valeur de retour

Type : [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes).

## Remarques

`XAsyncRun` est une fonction d'assistance qui exécute de manière asynchrone la fonction de rappel spécifiée dans *work*. Vous pouvez utiliser le `XAsyncBlock` spécifié dans *asyncBlock* pour annuler la fonction de rappel ou obtenir son état. `XAsyncRun` utilise en interne les fonctions `XAsyncProvider` suivantes pour exécuter et suivre la fonction de rappel :

* [XAsyncBegin](/fr-CA/reference/system/xasyncprovider/functions/xasyncbegin)
* [XAsyncComplete](/fr-CA/reference/system/xasyncprovider/functions/xasynccomplete)
* [XAsyncSchedule](/fr-CA/reference/system/xasyncprovider/functions/xasyncschedule)

Pour plus d'informations sur l'implémentation de votre propre fonctionnalité asynchrone avec `XAsyncProvider` et `XAsyncBlock`, consultez [Modèle de programmation asynchrone](/fr-CA/build/core-features/common/async/async-programming-model).

## Configuration requise

**En-tête :** XAsync.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Exécuter une tâche d'API du Microsoft Game Development Kit (GDK)](/fr-CA/build/core-features/common/async/async-libraries/async-library-xasync-example-run-gdk-task)
* [Exécuter une tâche simple](/fr-CA/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task)
* [Vue d'ensemble de la bibliothèque XAsync](/fr-CA/build/core-features/common/async/async-libraries/async-library-xasync)
* [Configurer l'annulation](/fr-CA/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability)
* [Configurer un fournisseur personnalisé](/fr-CA/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider)
* [Modèle de programmation asynchrone](/fr-CA/build/core-features/common/async/async-programming-model)
* [Wrapper générique de tâche asynchrone](/fr-CA/build/core-features/common/async/async-task-function-example)

## Voir aussi

[Membres XAsync](/fr-CA/reference/system/xasync/xasync_members)\
[Membres XAsyncProvider](/fr-CA/reference/system/xasyncprovider/xasyncprovider_members)\
[Modèle de programmation asynchrone](/fr-CA/build/core-features/common/async/async-programming-model)


## Related topics

- [XAsyncRun](/reference/system/xasync/functions/xasyncrun.md)
- [Run simple task example](/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
- [XAsyncWork](/reference/system/xasync/functions/xasyncwork.md)
- [XAsync](/reference/system/xasync/xasync_members.md)