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