<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 10.9.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCaptureDevice/activeVideoMaxFrameDuration",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCaptureDevice(py)activeVideoMaxFrameDuration"
  },
  "title" : "activeVideoMaxFrameDuration"
}
-->

# activeVideoMaxFrameDuration

The currently active maximum frame duration.

```
var activeVideoMaxFrameDuration: CMTime { get set }
```

## Discussion

A device’s maximum frame duration is the reciprocal of its minimum frame rate. You can set the value of this property to limit the minimum frame rate during a capture session. The capture device automatically chooses a default maximum frame duration based on its active format. After changing the value of this property, you can return to the default maximum frame duration by setting this property’s value to <doc://com.apple.documentation/documentation/CoreMedia/CMTime/invalid>. Choosing a new preset for the capture session also resets this property to its default value.

Attempting to set this property to a value not found in the active format’s [`videoSupportedFrameRateRanges`](/documentation/AVFoundation/AVCaptureDevice/Format/videoSupportedFrameRateRanges) array raises an exception (<doc://com.apple.documentation/documentation/Foundation/NSExceptionName/invalidArgumentException>).

> Important:
> Before changing the value of this property, you must call ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCaptureDevice/lockForConfiguration()`` to acquire exclusive access to the device’s configuration properties. Otherwise, setting the value of this property raises an exception. When you’re done configuring the device, call ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCaptureDevice/unlockForConfiguration()`` to release the lock.

This property value is key-value observable.

---

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)