IDStorageQueueX1::EnqueueSetEvent
Enfileira uma operação SetEvent.Sintaxe
Parâmetros
handleTipo: HANDLE Um identificador de evento.
Valor retornado
Tipo: voidComentários
O evento especificado é sinalizado quando todas as solicitações enfileiradas antes dele são concluídas. O evento pode ser de redefinição automática ou de redefinição manual. Depois de chamar este método, um thread do título pode aguardar o evento conforme necessário. Se o evento já estiver no estado sinalizado quando a operação de definição de evento ocorrer, uma mensagem de aviso será impressa no depurador se DSTORAGE_DEBUG_SHOW_ERRORS estiver ativado. Se o métodoEnqueueSetEvent preencher metade da capacidade da fila desde o
último envio, ele disparará um envio automático como parte da chamada de
EnqueueSetEvent.
Na maioria dos casos, esse método simplesmente faz uma gravação de memória na fila e, portanto, leva
muito pouco tempo de CPU para ser concluído. No entanto, se o envio automático for disparado,
ele levará significativamente mais tempo de CPU, incluindo uma transição para o modo kernel e
o processamento de todas as solicitações enviadas anteriormente no thread chamador.
Se o envio automático não for desejável, é recomendável que os jogos usem uma fila
com capacidade grande o suficiente e chamem Submit manualmente
quando apropriado.
Para obter mais informações, consulte as seções “Notification” e
“EnqueueStatus/EnqueueSignal/EnqueueSetEvent” em Visão geral do
DirectStorage.
Requisitos
Cabeçalho: dstorage_xs.h Biblioteca: dstorage_xs.lib Plataformas compatíveis: consoles XBOX SeriesConfira também
IDStorageQueueX::EnqueueStatusIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage