> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IDStorageQueueX::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](/pt-BR/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx).

*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](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit) manualmente
quando apropriado.

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

## Requisitos

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

**Biblioteca:** dstorage\_xs.lib

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

## Confira também

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


## Related topics

- [IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageQueueX::EnqueueSignal](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)