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

# EnqueueStatus

> IDStorageQueueX::EnqueueStatus

# IDStorageQueueX::EnqueueStatus

Enfileira uma gravação de status.

## Sintaxe

```cpp theme={null}
void EnqueueStatus(  
         IDStorageStatusArrayX *statusArray,  
         UINT32 index  
)  
```

### Parâmetros

*statusArray*\
Tipo: IDStorageStatusArrayX

Um objeto [IDStorageStatusArrayX](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx.md).

*index*\
Tipo: UINT32

Índice da entrada de status no objeto `IDStorageStatusArrayX` que receberá o status.

### Valor retornado

Tipo: void

## Comentários

A matriz de status é sinalizada quando todas as solicitações enfileiradas antes dela são concluídas.

Depois de chamar esse método, um thread do título pode sondar o objeto `IDStorageStatusArrayX`
conforme necessário. (O estado do status é indefinido até que esse método seja
chamado.) Se ocorrerem falhas desde a entrada de status anterior, o *HResult*
da entrada de status enfileirada armazenará o código de falha da primeira solicitação
com falha.

Se o método `EnqueueStatus` preencher metade da capacidade da fila desde o último
envio, ele disparará um envio automático como parte da chamada de `EnqueueStatus`.

Na maioria dos casos, esse método simplesmente faz uma gravação de memória na fila e, portanto, leva
muito pouco tempo de CPU para ser concluído. No entanto, se o envio automático for disparado,
ele levará significativamente mais tempo de CPU, incluindo uma transição para o modo kernel e
o processamento de todas as solicitações enviadas anteriormente no thread chamador.

Se o envio automático não for desejável, é recomendável que os jogos usem uma fila
com capacidade grande o suficiente e chamem [Submit](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md) manualmente
quando apropriado.

Para obter mais informações, consulte as seções "Notification" e
"EnqueueStatus/EnqueueSignal/EnqueueSetEvent" em [Visão geral do
DirectStorage](https://docs.xbox.com/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md).

## Requisitos

**Cabeçalho:** dstorage\_xs.h

**Biblioteca:** dstorage\_xs.lib

**Plataformas compatíveis:** consoles XBOX Series

## Confira também

[IDStorageFactoryX::CreateStatusArray](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createstatusarray.md)\
[IDStorageQueueX::EnqueueSignal](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)\
[IDStorageQueueX](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)\
[DStorage](https://docs.xbox.com/pt-BR/reference/system/dstorage/dstorage_members.md)


## Related topics

- [EnqueueSignal](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)
- [EnqueueSetEvent](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX1/methods/idstoragequeuex_enqueuesetevent.md)
- [CreateStatusArray](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createstatusarray.md)
- [Visão geral do DirectStorage](https://docs.xbox.com/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageStatusArrayX (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx.md)