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

# XAsyncSchedule

> XAsyncSchedule

# XAsyncSchedule

Agenda trabalho para a função de retorno de chamada de um provedor assíncrono.

## Sintaxe

```cpp theme={null}
HRESULT XAsyncSchedule(  
         XAsyncBlock* asyncBlock,  
         uint32_t delayInMs  
)  
```

### Parâmetros

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

Um ponteiro para o [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) que foi passado para [XAsyncBegin](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncbegin.md) para a chamada assíncrona.

*delayInMs*   \_In\_\
Tipo: uint32\_t

Quanto tempo o sistema deve aguardar, em milissegundos, antes de agendar a chamada assíncrona na fila assíncrona.

### Valor retornado

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

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](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

## Comentários

Esta função é opcional e oferece mais controle sobre o agendamento do trabalho assíncrono de um provedor assíncrono. Se o trabalho assíncrono puder ser feito por meio de um mecanismo assíncrono gerenciado pelo sistema, como [E/S sobreposta](https://learn.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-overlapped?redirectedfrom=MSDN), você não precisará chamar esta função.

Se o trabalho assíncrono precisar ser agendado após um atraso, especifique em *delayInMs* o número de milissegundos que [XAsyncSchedule](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncschedule.md) deve aguardar antes de agendar o trabalho assíncrono.

Para obter um exemplo de provedor assíncrono que usa `XAsyncSchedule` para agendar trabalho assíncrono, consulte a seção "Biblioteca assíncrona" em [Modelo de programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-programming-model.md#heading-7).

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

* [Configurar provedor personalizado](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
* [Modelo de programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-programming-model.md)

## Confira também

[Membros de XAsyncProvider](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/xasyncprovider_members.md)\
[XAsyncBegin](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncbegin.md)\
[XAsyncSchedule](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/functions/xasyncschedule.md)\
[Modelo de programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-programming-model.md)


## Related topics

- [Exemplo de configuração de provedor personalizado](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
- [XAsyncOp](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/enums/xasyncop.md)
- [XAsyncRun](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncrun.md)
- [XAsyncProvider (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xasyncprovider/xasyncprovider_members.md)
- [Modelo de programação assíncrona](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-programming-model.md)