Skip to main content

XAsyncCompletionRoutine

Representa la devolución de llamada de finalización de una llamada asincrónica.

Sintaxis

Parámetros

asyncBlock   _Inout_
Tipo: XAsyncBlock*
Un puntero al XAsyncBlock de la devolución de llamada de finalización.

Valor devuelto

Tipo: void

Comentarios

Opcionalmente, puede especificar un puntero XAsyncCompletionRoutine para proporcionar una devolución de llamada de finalización para una llamada asincrónica. Una devolución de llamada de finalización es una función de devolución de llamada que se ejecuta después de la finalización de una llamada asincrónica. Puede especificar un puntero XAsyncCompletionRoutine en el miembro callback de una estructura XAsyncBlock para una llamada asincrónica. Normalmente, una devolución de llamada de finalización procesa los resultados de una llamada asincrónica en otro subproceso. La devolución de llamada de finalización representa una función de devolución de llamada que se invoca cuando se completa la llamada asincrónica. La función de devolución de llamada toma un puntero XAsyncBlock, que posteriormente se usa para obtener los resultados de la función de devolución de llamada. Si especifica una devolución de llamada de finalización, puede comprobar periódicamente si la devolución de llamada de finalización se ha completado mediante la función XAsyncGetStatus y, a continuación, usar XAsyncGetResult y XAsyncGetResultSize según sea necesario para obtener los resultados de la tarea completada. Una devolución de llamada de finalización se invoca incluso si se invoca XAsyncCancel para cancelar la llamada asincrónica. Use XAsyncGetStatus o el método Get\*Result de la devolución de llamada de finalización para obtener los resultados de la llamada asincrónica. Si la llamada asincrónica se canceló, estos métodos devuelven E_ABORT. Para obtener más información sobre el patrón de implementación de un proveedor asincrónico, incluido el método Get\*Result, consulte Modelo de programación asincrónica.

Requisitos

Encabezado: XAsync.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

Miembros de XAsync
XAsyncGetStatus
Modelo de programación asincrónica
Última modificación el 28 de agosto de 2026