hardwareSurface

The hardware surface behind this frame, or null when its pixels are in main memory.

What the pointer is depends on the decoder: a CVPixelBuffer for VideoToolbox, a MediaCodec output buffer, a VA-API surface. Only a renderer matched to that decoder can interpret it, which is why it is returned untyped. It is valid until the frame is closed.