IDStorageQueueX::EnqueueStatus
상태 쓰기를 큐에 등록합니다.구문
매개 변수
statusArray형식: IDStorageStatusArrayX IDStorageStatusArrayX 개체입니다. index
형식: UINT32 상태를 받을
IDStorageStatusArrayX 개체 내 상태 항목의 인덱스입니다.
반환 값
형식: void설명
상태 배열은 그보다 앞서 큐에 등록된 모든 요청이 완료되면 신호를 받습니다. 이 메서드를 호출한 후에는 타이틀 스레드가 필요에 따라IDStorageStatusArrayX 개체를 폴링할 수 있습니다. (이 메서드가 호출될 때까지 상태의 상태는 정의되지 않습니다.) 이전 상태 항목 이후 어떤 실패라도 발생했다면, 등록된 상태 항목의 HResult에는 첫 번째 실패한 요청의 실패 코드가 저장됩니다.
EnqueueStatus 메서드가 마지막 제출 이후 큐 용량의 절반을 채우면, EnqueueStatus 호출의 일부로 자동 제출이 트리거됩니다.
대부분의 경우 이 메서드는 단순히 큐에 대한 메모리 쓰기만 수행하므로 완료하는 데 CPU 시간이 거의 걸리지 않습니다. 그러나 자동 제출이 트리거되면 커널 모드 전환과 이전에 제출된 모든 요청을 호출자 스레드에서 처리하는 것을 포함하여 훨씬 더 많은 CPU 시간이 소요됩니다.
자동 제출이 바람직하지 않은 경우, 게임에서는 충분히 큰 용량의 큐를 사용하고 적절한 시점에 Submit을 수동으로 호출하는 것이 좋습니다.
자세한 내용은 DirectStorage 개요의 “Notification” 및 “EnqueueStatus/EnqueueSignal/EnqueueSetEvent” 섹션을 참조하세요.
요구 사항
헤더: dstorage_xs.h 라이브러리: dstorage_xs.lib 지원되는 플랫폼: XBOX Series 콘솔함께 보기
IDStorageFactoryX::CreateStatusArrayIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage