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

상태 쓰기를 큐에 등록합니다.

## 구문

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

### 매개 변수

*statusArray*\
형식: IDStorageStatusArrayX

[IDStorageStatusArrayX](/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx) 개체입니다.

*index*\
형식: UINT32

상태를 받을 `IDStorageStatusArrayX` 개체 내 상태 항목의 인덱스입니다.

### 반환 값

형식: void

## 설명

상태 배열은 그보다 앞서 큐에 등록된 모든 요청이 완료되면 신호를 받습니다.

이 메서드를 호출한 후에는 타이틀 스레드가 필요에 따라 `IDStorageStatusArrayX` 개체를 폴링할 수 있습니다. (이 메서드가 호출될 때까지 상태의 상태는 정의되지 않습니다.) 이전 상태 항목 이후 어떤 실패라도 발생했다면, 등록된 상태 항목의 *HResult*에는 첫 번째 실패한 요청의 실패 코드가 저장됩니다.

`EnqueueStatus` 메서드가 마지막 제출 이후 큐 용량의 절반을 채우면, `EnqueueStatus` 호출의 일부로 자동 제출이 트리거됩니다.

대부분의 경우 이 메서드는 단순히 큐에 대한 메모리 쓰기만 수행하므로 완료하는 데 CPU 시간이 거의 걸리지 않습니다. 그러나 자동 제출이 트리거되면 커널 모드 전환과 이전에 제출된 모든 요청을 호출자 스레드에서 처리하는 것을 포함하여 훨씬 더 많은 CPU 시간이 소요됩니다.

자동 제출이 바람직하지 않은 경우, 게임에서는 충분히 큰 용량의 큐를 사용하고 적절한 시점에 [Submit](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit)을 수동으로 호출하는 것이 좋습니다.

자세한 내용은 [DirectStorage 개요](/build/console-features/storage/directstorage/directstorage-overview)의 "Notification" 및 "EnqueueStatus/EnqueueSignal/EnqueueSetEvent" 섹션을 참조하세요.

## 요구 사항

**헤더:** dstorage\_xs.h

**라이브러리:** dstorage\_xs.lib

**지원되는 플랫폼:** XBOX Series 콘솔

## 함께 보기

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


## Related topics

- [IDStorageQueueX::EnqueueSignal](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)
- [IDStorageQueueX1::EnqueueSetEvent](/ko/reference/system/dstorage/interfaces/IDStorageQueueX1/methods/idstoragequeuex_enqueuesetevent.md)
- [IDStorageStatusArrayX](/ko/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx.md)
- [IDStorageFactoryX::CreateStatusArray](/ko/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createstatusarray.md)
- [IDStorageQueueX::EnqueueRequest](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuerequest.md)