sampleCounters(sampleBuffer:sampleIndex:barrier:)
Encodes a command that samples hardware counters during the render pass and stores the data into a counter sample buffer.
Declaration
func sampleCounters(sampleBuffer: any MTLCounterSampleBuffer, sampleIndex: Int, barrier: Bool)Parameters
- sampleBuffer:
An Mtlcountersamplebuffer instance that stores the GPU hardware data.
- sampleIndex:
An index within
sampleBufferthe command stores the data to. - barrier:
A Boolean value that indicates whether the command inserts a barrier before sampling the counter’s data.
A barrier ensures that the commands you encode before this one complete before the GPU samples the hardware counters, but can negatively impact runtime performance.
Running this command without a barrier means the GPU can sample counters concurrently with other commands from the encoder.
Either way, the
barrierparameter for the command has no impact on sampling commands from other passes.