XAsyncOp

Representa um código de operação para um provedor assíncrono.

Sintaxe

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

Constantes

Constante	Descrição
Begin	O provedor assíncrono é invocado com este código de operação quando XAsyncBegin é invocado. Se este código de operação for implementado, o provedor assíncrono deverá iniciar seu trabalho assíncrono, chamando XAsyncSchedule ou iniciando um processo assíncrono externo, como E/S sobreposta. OBSERVAÇÃO O trabalho assíncrono realizado para este código de operação não deve bloquear o thread.
DoWork	O provedor assíncrono é invocado com este código de operação quando XAsyncSchedule foi chamado para agendar trabalho. Se este código de operação for implementado, o provedor assíncrono deverá realizar seu trabalho assíncrono e, em seguida, chamar XAsyncComplete, especificando o tamanho do conteúdo de dados em requiredBufferSize. Se for necessário realizar trabalho adicional, o provedor assíncrono poderá agendá-lo e, em seguida, chamar `XAsyncComplete`, especificando o código de erro E_PENDING em result.
GetResult	O provedor assíncrono é invocado com este código de operação depois que uma chamada assíncrona é concluída e o usuário precisa obter o conteúdo de dados resultante. Os valores dos campos buffer e bufferSize de XAsyncProviderData já foram validados.
Cancel	O provedor assíncrono é invocado com este código de operação quando o trabalho assíncrono deve ser cancelado. O provedor assíncrono deve cancelar todo o trabalho assíncrono e, em seguida, chamar XAsyncComplete, especificando o código de erro E_ABORT em result.
Cleanup	O provedor assíncrono é invocado com este código de operação quando a chamada assíncrona é concluída ou cancelada e os dados no contexto podem ser limpos.

Comentários

A função de retorno de chamada XAsyncProvider de um provedor assíncrono é chamada repetidamente, e o que esse provedor assíncrono deve fazer em cada chamada é determinado pelo código de operação especificado para cada chamada. XAsyncOp representa os códigos de operação que podem ser implementados por um provedor assíncrono.
Um provedor assíncrono 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. Para obter um exemplo de provedor assíncrono que implementa os códigos de operação DoWork, GetResult e Cleanup de XAsyncOp, consulte a seção “Biblioteca assíncrona” em Modelo de programação assíncrona.

Requisitos

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

Confira também

XAsyncProviderData
Membros de XAsyncProvider
Modelo de programação assíncrona

Porting

Build Paths

XAsyncOp

XAsyncOp

Sintaxe

Constantes

Comentários

Requisitos

Confira também

​XAsyncOp

​Sintaxe

​Constantes

​Comentários

​Requisitos

​Confira também

XAsyncOp

Sintaxe

Constantes

Comentários

Requisitos

Confira também