IDStorageQueueX1::EnqueueSetEvent
Pone en cola una operación SetEvent.Sintaxis
Parámetros
handleTipo: HANDLE Identificador de evento.
Valor devuelto
Tipo: voidComentarios
El evento especificado se señala cuando se completan todas las solicitudes puestas en cola antes que él. El evento puede ser de restablecimiento automático o de restablecimiento manual. Después de llamar a este método, un subproceso del título puede esperar por el evento según sea necesario. Si el evento ya está en estado señalado cuando se produce la operación de establecimiento de evento, se imprime un mensaje de advertencia en el depurador si DSTORAGE_DEBUG_SHOW_ERRORS está activado. Si el métodoEnqueueSetEvent 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
EnqueueSetEvent.
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
IDStorageQueueX::EnqueueStatusIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage