> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAsyncRun

> XAsyncRun

# XAsyncRun

Ejecuta de forma asincrónica la función de devolución de llamada especificada.

## Sintaxis

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

### Parámetros

*asyncBlock*   \_Inout\_\
Tipo: [XAsyncBlock\*](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md)

Un puntero al [XAsyncBlock](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md) que se usa para realizar el seguimiento de la llamada asincrónica.

*work*   \_In\_\
Tipo: [XAsyncWork\*](https://docs.xbox.com/es/reference/system/xasync/functions/xasyncwork.md)

Un puntero a una función de devolución de llamada que se ejecutará de forma asincrónica.

### Valor devuelto

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

Devuelve `S_OK` si se realiza correctamente; de lo contrario, devuelve un código de error. Para ver una lista de códigos de error, consulte [Códigos de error](https://docs.xbox.com/es/reference/errorcodes.md).

## Comentarios

`XAsyncRun` es una función auxiliar que ejecuta de forma asincrónica la función de devolución de llamada especificada en *work*. Puede usar el `XAsyncBlock` especificado en *asyncBlock* para cancelar la función de devolución de llamada u obtener su estado. `XAsyncRun` usa internamente las siguientes funciones de `XAsyncProvider` para ejecutar la función de devolución de llamada y realizar su seguimiento:

* [XAsyncBegin](https://docs.xbox.com/es/reference/system/xasyncprovider/functions/xasyncbegin.md)
* [XAsyncComplete](https://docs.xbox.com/es/reference/system/xasyncprovider/functions/xasynccomplete.md)
* [XAsyncSchedule](https://docs.xbox.com/es/reference/system/xasyncprovider/functions/xasyncschedule.md)

Para obtener más información sobre cómo implementar su propia funcionalidad asincrónica con `XAsyncProvider` y `XAsyncBlock`, consulte [Modelo de programación asincrónica](https://docs.xbox.com/es/build/core-features/common/async/async-programming-model.md).

## Requisitos

**Encabezado:** XAsync.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Ejecutar una tarea de API del Microsoft Game Development Kit (GDK)](https://docs.xbox.com/es/build/core-features/common/async/async-libraries/async-library-xasync-example-run-gdk-task.md)
* [Ejecutar una tarea sencilla](https://docs.xbox.com/es/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
* [Información general de la biblioteca XAsync](https://docs.xbox.com/es/build/core-features/common/async/async-libraries/async-library-xasync.md)
* [Configurar la capacidad de cancelación](https://docs.xbox.com/es/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability.md)
* [Configurar un proveedor personalizado](https://docs.xbox.com/es/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
* [Modelo de programación asincrónica](https://docs.xbox.com/es/build/core-features/common/async/async-programming-model.md)
* [Wrapper genérico para tareas asincrónicas](https://docs.xbox.com/es/build/core-features/common/async/async-task-function-example.md)

## Consulte también

[Miembros de XAsync](https://docs.xbox.com/es/reference/system/xasync/xasync_members.md)\
[Miembros de XAsyncProvider](https://docs.xbox.com/es/reference/system/xasyncprovider/xasyncprovider_members.md)\
[Modelo de programación asincrónica](https://docs.xbox.com/es/build/core-features/common/async/async-programming-model.md)


## Related topics

- [XAsyncWork](https://docs.xbox.com/es/reference/system/xasync/functions/xasyncwork.md)
- [Ejemplo de ejecución de una tarea simple](https://docs.xbox.com/es/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
- [XAsync (contenido de la API)](https://docs.xbox.com/es/reference/system/xasync/xasync_members.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XGameUiShowStateShareResult](https://docs.xbox.com/es/reference/system/xgameui/functions/xgameuishowstateshareresult.md)