SetEvent 작업을 큐에 추가합니다.
구문
void EnqueueSetEvent(
HANDLE handle
)
매개 변수
handle
형식: HANDLE
이벤트 핸들입니다.
반환 값
형식: void
비고
지정된 이벤트는 큐에 추가된 그 앞의 모든 요청이 완료되면 신호를 받습니다. 이벤트는 자동 재설정 또는 수동 재설정일 수 있습니다.
이 메서드를 호출한 후 타이틀 스레드는 필요에 따라 이벤트를 기다릴 수 있습니다. 이벤트 설정 작업이 발생할 때 이벤트가 이미 신호를 받은 상태인 경우 DSTORAGE_DEBUG_SHOW_ERRORS가 켜져 있으면 디버거에 경고 메시지가 출력됩니다.
EnqueueSetEvent 메서드가 마지막 제출 이후 큐 용량의 절반을 채우는 경우 EnqueueSetEvent 호출의 일부로 자동 제출이 트리거됩니다.
대부분의 경우 이 메서드는 단순히 큐에 메모리 쓰기를 수행하므로 완료하는 데 CPU 시간이 거의 걸리지 않습니다. 그러나 자동 제출이 트리거되면 커널 모드 전환 및 호출자 스레드에서 이전에 제출된 모든 요청을 처리하는 등의 CPU 시간이 훨씬 더 많이 걸립니다.
자동 제출이 바람직하지 않은 경우 게임은 용량이 충분히 큰 큐를 사용하고 적절한 경우 수동으로 제출을 호출하는 것이 좋습니다.
자세한 내용은 DirectStorage 개요의 "알림" 및 "EnqueueStatus/EnqueueSignal/EnqueueSetEvent" 섹션을 참조하세요.
요구 사항
헤더: dstorage_xs.h
라이브러리: dstorage_xs.lib
지원되는 플랫폼: Xbox Series 콘솔
참고 항목
IDStorageQueueX::EnqueueStatus
IDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage