capture

Acquires an immutable-content source lease before issuing any GPU work.

The device calls this at most once per actual presentation and only after reserving an available target. A returned capture remains owned by the device until its capture-completion fence signals.

Return

a capture lease, or null to keep the last committed generation and its snapshot unchanged.

Throws

when acquisition fails, without transferring a lease or issuing GPU work.