IDStorageQueueX::EnqueueStatus
Pone en cola una escritura de estado.Sintaxis
Parámetros
statusArrayTipo: IDStorageStatusArrayX Un objeto IDStorageStatusArrayX. index
Tipo: UINT32 Índice de la entrada de estado del objeto
IDStorageStatusArrayX que recibirá el estado.
Valor devuelto
Tipo: voidComentarios
La matriz de estado se señala cuando se completan todas las solicitudes puestas en cola antes que ella. Después de llamar a este método, un subproceso del título puede sondear el objetoIDStorageStatusArrayX
según sea necesario. (El estado no está definido hasta que se llama a este
método.) Si se produjo algún error desde la entrada de estado anterior, el HResult
de la entrada de estado puesta en cola almacena el código de error de la primera solicitud
con error.
Si el método EnqueueStatus llena la mitad de la capacidad de la cola desde el último
envío, desencadena un envío automático como parte de la llamada a
EnqueueStatus.
En la mayoría de los casos, este método simplemente realiza una escritura en memoria en la cola y, por tanto, tarda
muy poco tiempo de CPU en completarse. Sin embargo, si se desencadena el envío automático,
consume bastante más tiempo de CPU, incluida una transición al modo kernel y
el procesamiento de todas las solicitudes enviadas anteriormente en el subproceso del autor de la llamada.
Si el envío automático no es deseable, se recomienda que los juegos usen una cola
con capacidad suficientemente grande y llamen a Submit manualmente
cuando corresponda.
Para obtener más información, consulte las secciones “Notification” y
“EnqueueStatus/EnqueueSignal/EnqueueSetEvent” en Información general de
DirectStorage.
Requisitos
Encabezado: dstorage_xs.h Biblioteca: dstorage_xs.lib Plataformas compatibles: consolas XBOX SeriesConsulte también
IDStorageFactoryX::CreateStatusArrayIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage