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

# IDStorageQueueX1::EnqueueSetEvent

> IDStorageQueueX1::EnqueueSetEvent

# IDStorageQueueX1::EnqueueSetEvent

**SetEvent** 작업을 큐에 등록합니다.

## 구문

```cpp theme={null}
void EnqueueSetEvent(  
         HANDLE handle  
)  
```

### 매개 변수

*handle*\
형식: HANDLE

이벤트 핸들입니다.

### 반환 값

형식: void

## 설명

지정된 이벤트는 그보다 앞서 큐에 등록된 모든 요청이 완료되면 신호를 받습니다. 이벤트는 자동 재설정이거나 수동 재설정일 수 있습니다.

이 메서드를 호출한 후에는 타이틀 스레드가 필요에 따라 이벤트를 대기할 수 있습니다. 설정 이벤트 작업이 일어날 때 이벤트가 이미 신호 상태인 경우, DSTORAGE\_DEBUG\_SHOW\_ERRORS가 켜져 있으면 디버거에 경고 메시지가 인쇄됩니다.

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

대부분의 경우 이 메서드는 단순히 큐에 대한 메모리 쓰기만 수행하므로 완료하는 데 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 콘솔

## 함께 보기

[IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus)\
[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

- [IDStorageQueueX1](/ko/reference/system/dstorage/interfaces/IDStorageQueueX1/idstoragequeuex1.md)
- [DirectStorage 개요](/ko/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageQueueX::Submit](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX2](/ko/reference/system/dstorage/interfaces/IDStorageQueueX2/idstoragequeuex2.md)
- [IDStorageQueueX::EnqueueSignal](/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)