Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
GPUCommandEncoder: finish()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur insicheren Kontexten (HTTPS) in einigen oder allenunterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist inWeb Workers verfügbar.
Diefinish()-Methode derGPUCommandEncoder-Schnittstelle schließt die Aufzeichnung der auf diesemGPUCommandEncoder codierten Befehlssequenz ab und gibt einen entsprechendenGPUCommandBuffer zurück.
Syntax
finish()finish(descriptor)Parameter
descriptorOptionalEin Objekt, das die folgenden Eigenschaften enthalten kann:
labelOptionalEin String, der eine Bezeichnung für den zurückgegebenen
GPUCommandBufferangibt, die zur Identifizierung verwendet werden kann, zum Beispiel inGPUError-Meldungen oder Konsolenwarnungen.
Rückgabewert
Eine Instanz desGPUCommandBuffer-Objekts.
Validierung
Die folgenden Kriterien müssen erfüllt sein, wennfinish() aufgerufen wird. Andernfalls wird einGPUValidationError erzeugt und derGPUCommandEncoder wird ungültig:
- Es dürfen keine aktiven Debug-Gruppen vorhanden sein (d.h. gestartet über
pushDebugGroup()). - Der
GPUCommandEncodermuss sich in einem offenen Zustand befinden — das bedeutet:- Es dürfen keine untergeordneten
GPUComputePassEncoder- oderGPURenderPassEncoder-Instanzen aktiv sein, die nicht beendet wurden (durch Aufruf vonend()). - Der
GPUCommandEncoderdarf noch nichtfinish()aufgerufen haben (in diesem Fall kann er nicht mehr zum Kodieren weiterer Befehle verwendet werden).
- Es dürfen keine untergeordneten
Beispiele
// …const commandBuffer = commandEncoder.finish();device.queue.submit([commandBuffer]);// …Spezifikationen
| Specification |
|---|
| WebGPU # dom-gpucommandencoder-finish |
Browser-Kompatibilität
Siehe auch
- DieWebGPU API