DieresolveQuerySet()-Methode desGPUCommandEncoder-Interfaces kodiert einen Befehl, der einGPUQuerySet auflöst, indem die Ergebnisse in einen angegebenenGPUBuffer kopiert werden.

Syntax

resolveQuerySet(querySet, firstQuery, queryCount, destination, destinationOffset)

Parameter

querySet

EinGPUQuerySet-Objekt, das das aufzulösende Abfrageset repräsentiert.

firstQuery

Die Indexnummer des ersten Abfragewerts, der in den Puffer kopiert werden soll.

queryCount

Die Anzahl der Abfragen, die abfirstQuery in den Puffer kopiert werden sollen.

destination

EinGPUBuffer, der den Puffer repräsentiert, in den die Abfragewerte kopiert werden sollen.

destinationOffset

Eine Zahl, die den Versatz in Bytes vom Anfang des Puffers angibt, an dem mit dem Schreiben der Abfragewerte begonnen wird.

Rückgabewert

Keiner (Undefined).

Validierung

Die folgenden Kriterien müssen beim Aufruf vonresolveQuerySet() erfüllt sein, andernfalls wird einGPUValidationError erzeugt und derGPUCommandEncoder wird ungültig:

• Dasdestination.buffer'sGPUBuffer.usage enthält dasGPUBufferUsage.QUERY_RESOLVE-Flag.
• firstQuery ist kleiner als die Anzahl der Abfragen inquerySet.
• firstQuery +queryCount ist kleiner als oder gleich der Anzahl der Abfragen inquerySet.
• destinationOffset ist ein Vielfaches von 256.
• destinationOffset + 8 ×queryCount ist kleiner als oder gleichdestination.size.

Beispiele

// …const queryBuffer = device.createBuffer({  size: 1024,  usage: GPUBufferUsage.QUERY_RESOLVE,});const querySet = device.createQuerySet({  type: "timestamp",  count: 32,});// …const commandEncoder = device.createCommandEncoder();// Write timestamps to querySetcommandEncoder.writeTimestamp(querySet, 0);// …commandEncoder.writeTimestamp(querySet, 1);// etc.// …commandEncoder.resolveQuerySet(  querySet,  0, // First query to write  16, // Number of queries to count  queryBuffer,  0, // Buffer offset);// …

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DieWebGPU API