Skip to main content

Função XAsyncProvider

Representa a função de retorno de chamada de uma chamada assíncrona para um provedor assíncrono.

Sintaxe

Parâmetros

op   _In_
Tipo: XAsyncOp
O código de operação a ser executado pela função de retorno de chamada. data   _Inout_
Tipo: XAsyncProviderData*
Um ponteiro para a estrutura XAsyncProviderData usada para armazenar dados da chamada assíncrona e acompanhá-la.

Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

A função de retorno de chamada XAsyncProvider é implementada por um provedor assíncrono para realizar trabalho assíncrono. A função de retorno de chamada de um provedor assíncrono é chamada repetidamente pela API XAsync, e o que essa função de retorno de chamada deve fazer em cada chamada é determinado pelo código de operação XAsyncOp especificado em op para cada chamada. Os dados usados pela função de retorno de chamada em cada chamada, incluindo o XAsyncBlock usado para acompanhar essa função de retorno de chamada, são especificados em data. A função de retorno de chamada deve implementar apenas os códigos de operação de XAsyncOp necessários para realizar o trabalho assíncrono. Por exemplo, um provedor assíncrono que realiza trabalho de E/S assíncrona não cancelável e que não requer limpeza só precisa implementar XAsyncOp::GetResult na função de retorno de chamada desse provedor assíncrono. Para obter um exemplo de provedor assíncrono que implementa os códigos de operação DoWork, GetResult e Cleanup de XAsyncOp e retorna um conteúdo de dados, consulte a seção “Biblioteca assíncrona” em Modelo de programação assíncrona.

Requisitos

Cabeçalho: XAsyncProvider.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

Membros de XAsyncProvider
XAsyncOp
XAsyncProviderData
Modelo de programação assíncrona
Last modified on October 6, 2026