GPUQueue: Methode onSubmittedWorkDone()

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die onSubmittedWorkDone()-Methode der GPUQueue-Schnittstelle gibt ein Promise zurück, das aufgelöst wird, wenn alle Arbeiten, die der GPU über diese GPUQueue zum Zeitpunkt des Aufrufs der Methode zugewiesen wurden, verarbeitet sind.

Dies schließt den Abschluss aller mapAsync()-Aufrufe ein, die an GPUBuffer-Objekten vorgenommen wurden, die in der Warteschlange vor dem Aufruf von onSubmittedWorkDone() verwendet werden.

Hinweis: In den meisten Fällen müssen Sie onSubmittedWorkDone() nicht aufrufen. Sie müssen es nicht für das Mapping eines Puffers aufrufen. mapAsync garantiert, dass die Arbeit, die vor dem Aufruf von mapAsync in die Warteschlange eingereiht wird, vor der Rückgabe von mapAsync abgeschlossen wird (siehe WebGPU-Spezifikation).

Die zwei Anwendungsfälle für onSubmittedWorkDone

Warten auf mehrere Puffer-Zuweisungen (langsam)
js
```
// good
await Promise.all([
  buffer1.mapAsync(),
  buffer2.mapAsync(),
  buffer3.mapAsync(),
]);
data1 = buffer1.getMappedRange();
data2 = buffer2.getMappedRange();
data3 = buffer3.getMappedRange();
```
js
```
// works but slow
buffer1.mapAsync();
buffer2.mapAsync();
buffer3.mapAsync();
await device.queue.onSubmittedWorkDone();
data1 = buffer1.getMappedRange();
data2 = buffer2.getMappedRange();
data3 = buffer3.getMappedRange();
```
Der Grund, warum die zweite Methode langsam ist, liegt darin, dass die Implementierung möglicherweise die Puffer zuweisen kann, bevor alle eingereichten Arbeiten abgeschlossen sind. Beispielsweise, wenn alle Puffer fertig verwendet werden, aber mehr Arbeit (unabhängig von den Puffern) bereits eingereicht ist, dann werden Sie mit der zweiten Methode länger warten als mit der ersten.
Arbeit drosseln

Wenn Sie schwere Berechnungen durchführen und zu viel Arbeit auf einmal einreichen, kann der Browser Ihre Arbeit beenden. Sie können die Arbeit drosseln, indem Sie erst dann mehr Arbeit einreichen, wenn die bereits eingereichte Arbeit abgeschlossen ist.

Syntax

onSubmittedWorkDone()

device.queue.submit([commandEncoder.finish()]);
device.queue.onSubmittedWorkDone().then(() => {
  console.log("All submitted commands processed.");
});