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

> IDStorageQueueX::EnqueueRequest

# IDStorageQueueX::EnqueueRequest

읽기 요청을 큐에 등록합니다.

## 구문

```cpp theme={null}
void EnqueueRequest(  
         const DSTORAGE_REQUEST *request  
)  
```

### 매개 변수

*request*\
형식: [DSTORAGE\_REQUEST](/reference/system/dstorage/structs/dstorage_request)

큐에 등록할 읽기 요청입니다.

### 반환 값

형식: void

## 설명

이 메서드는 *request*의 데이터를 큐에 등록합니다.
[DSTORAGE\_REQUEST](/reference/system/dstorage/structs/dstorage_request) 구조체는 메서드가 반환되는 즉시 다시 사용할 수 있습니다.

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

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

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

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

## 요구 사항

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

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

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

## 함께 보기

[IDStorageQueueX](/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_REQUEST_OPTIONS](/ko/reference/system/dstorage/structs/dstorage_request_options.md)
- [DSTORAGE_REQUEST](/ko/reference/system/dstorage/structs/dstorage_request.md)
- [IDStorageQueueX::EnqueueSignal](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)
- [IDStorageQueueX::EnqueueStatus](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageQueueX::CancelRequestsWithTag](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_cancelrequestswithtag.md)