<!--
{
  "availability" : [
    "macOS: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Virtualization",
  "identifier" : "/documentation/Virtualization/VZGraphicsDisplay/reconfigure(configuration:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Virtualization"
    ],
    "preciseIdentifier" : "c:objc(cs)VZGraphicsDisplay(im)reconfigureWithConfiguration:error:"
  },
  "title" : "reconfigure(configuration:)"
}
-->

# reconfigure(configuration:)

Reconfigure this display with the new display configuration you provide.

```
func reconfigure(configuration: VZGraphicsDisplayConfiguration) throws
```

## Parameters

`configuration`

The new [`VZGraphicsDisplayConfiguration`](/documentation/Virtualization/VZGraphicsDisplayConfiguration) configuration.

## Discussion

> Important:
> The type of configuration you pass to this method needs to match the corresponding type that you used to create this display.

If successful, the framework passes the new configuration to the guest, but the guest may or may not respond to parts of the configuration. If the guest doesn’t use the new configuration, the Virtualization framework doesn’t return an error.

Reconfiguration of the display triggers a display state change that you can track by adopting the [`VZGraphicsDisplayObserver`](/documentation/Virtualization/VZGraphicsDisplayObserver) protocol.

---

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)