Skip to main content

IDStorageQueueX1::EnqueueSetEvent

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

구문

매개 변수

handle
형식: HANDLE
이벤트 핸들입니다.

반환 값

형식: void

설명

지정된 이벤트는 그보다 앞서 큐에 등록된 모든 요청이 완료되면 신호를 받습니다. 이벤트는 자동 재설정이거나 수동 재설정일 수 있습니다. 이 메서드를 호출한 후에는 타이틀 스레드가 필요에 따라 이벤트를 대기할 수 있습니다. 설정 이벤트 작업이 일어날 때 이벤트가 이미 신호 상태인 경우, DSTORAGE_DEBUG_SHOW_ERRORS가 켜져 있으면 디버거에 경고 메시지가 인쇄됩니다. EnqueueSetEvent 메서드가 마지막 제출 이후 큐 용량의 절반을 채우면, EnqueueSetEvent 호출의 일부로 자동 제출이 트리거됩니다. 대부분의 경우 이 메서드는 단순히 큐에 대한 메모리 쓰기만 수행하므로 완료하는 데 CPU 시간이 거의 걸리지 않습니다. 그러나 자동 제출이 트리거되면 커널 모드 전환과 이전에 제출된 모든 요청을 호출자 스레드에서 처리하는 것을 포함하여 훨씬 더 많은 CPU 시간이 소요됩니다. 자동 제출이 바람직하지 않은 경우, 게임에서는 충분히 큰 용량의 큐를 사용하고 적절한 시점에 Submit을 수동으로 호출하는 것이 좋습니다. 자세한 내용은 DirectStorage 개요의 “Notification” 및 “EnqueueStatus/EnqueueSignal/EnqueueSetEvent” 섹션을 참조하세요.

요구 사항

헤더: dstorage_xs.h 라이브러리: dstorage_xs.lib 지원되는 플랫폼: XBOX Series 콘솔

함께 보기

IDStorageQueueX::EnqueueStatus
IDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage
마지막 수정일 2026년 8월 24일