IDStorageQueueX::EnqueueStatus
Enfileira uma gravação de status.Sintaxe
Parâmetros
statusArrayTipo: IDStorageStatusArrayX Um objeto IDStorageStatusArrayX. index
Tipo: UINT32 Índice da entrada de status no objeto
IDStorageStatusArrayX que receberá o status.
Valor retornado
Tipo: voidComentários
A matriz de status é sinalizada quando todas as solicitações enfileiradas antes dela são concluídas. Depois de chamar esse método, um thread do título pode sondar o objetoIDStorageStatusArrayX
conforme necessário. (O estado do status é indefinido até que esse método seja
chamado.) Se ocorrerem falhas desde a entrada de status anterior, o HResult
da entrada de status enfileirada armazenará o código de falha da primeira solicitação
com falha.
Se o método EnqueueStatus preencher metade da capacidade da fila desde o último
envio, ele disparará um envio automático como parte da chamada de EnqueueStatus.
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
IDStorageFactoryX::CreateStatusArrayIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage