<!--
{
  "availability" : [
    "macCatalyst: 14.0.0 -",
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "ParavirtualizedGraphics",
  "identifier" : "/documentation/ParavirtualizedGraphics/PGTraceRangeHandler",
  "metadataVersion" : "0.1.0",
  "role" : "Type Alias",
  "symbol" : {
    "kind" : "Type Alias",
    "modules" : [
      "Paravirtualized Graphics"
    ],
    "preciseIdentifier" : "c:@T@PGTraceRangeHandler"
  },
  "title" : "PGTraceRangeHandler"
}
-->

# PGTraceRangeHandler

The block signature for a routine that handles trace requests.

```
typedef void (^)(struct PGPhysicalMemoryRange_s *) PGTraceRangeHandler;
```

## Parameters

`dirty  `

The range of memory that the guest changed.

## Discussion

The returned range may be larger than the range that the guest wrote into. For example, if you can only determine which memory the guest accessed at virtual memory page boundaries, you’d report that the entire page changed. Where possible, coalesce writes over a period of time into a single activity notification.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)