<!--
{
  "availability" : [
    "macCatalyst: 13.1.0 -",
    "macOS: 10.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreGraphics",
  "identifier" : "/documentation/CoreGraphics/CGAcquireDisplayFadeReservation(_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Core Graphics"
    ],
    "preciseIdentifier" : "c:@F@CGAcquireDisplayFadeReservation"
  },
  "title" : "CGAcquireDisplayFadeReservation(_:_:)"
}
-->

# CGAcquireDisplayFadeReservation(_:_:)

Reserves the fade hardware for a specified time interval.

```
func CGAcquireDisplayFadeReservation(_ seconds: CGDisplayReservationInterval, _ token: UnsafeMutablePointer<CGDisplayFadeReservationToken>?) -> CGError
```

## Parameters

`seconds`

The desired number of seconds to reserve the fade hardware. An application can specify any value in the interval `(0, kCGMaxDisplayReservationInterval]`.

`token`

A pointer to storage (provided by the caller) for a fade reservation token. On return, the storage contains a new token.

## Return Value

Returns [`CGError.noneAvailable`](/documentation/CoreGraphics/CGError/noneAvailable) if another fade reservation is in effect. Otherwise, returns [`CGError.success`](/documentation/CoreGraphics/CGError/success).

## Discussion

Before performing a fade operation, an application must reserve the fade hardware for a specified period of time. Quartz returns a token that represents a new fade reservation. The application uses this token as an argument in subsequent calls to other display fade functions.

During the fade reservation interval, the application has exclusive rights to use the fade hardware. At the end of the interval, the token becomes invalid and the hardware automatically returns to a normal state. Typically, the application calls [`CGReleaseDisplayFadeReservation(_:)`](/documentation/CoreGraphics/CGReleaseDisplayFadeReservation(_:)) to release the fade reservation before it expires.

---

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)