<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 18.2.0 -",
    "macOS: 12.3.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ScreenCaptureKit",
  "identifier" : "/documentation/ScreenCaptureKit/SCFrameStatus",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "ScreenCaptureKit"
    ],
    "preciseIdentifier" : "c:@E@SCFrameStatus"
  },
  "title" : "SCFrameStatus"
}
-->

# SCFrameStatus

Status values for a frame from a stream.

```
enum SCFrameStatus
```

## Overview

You create a frame status by initializing it with the value you retrieve for the [`status`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/status) from the sample buffer’s attachments dictionary.

```swift
if let statusRawValue = attachments[SCStreamFrameInfo.status] as? Int {
    // Create status value.
    let status = SCFrameStatus(rawValue: statusRawValue)
    ...
}
```

## Topics

### Status values

[`SCFrameStatus.complete`](/documentation/ScreenCaptureKit/SCFrameStatus/complete)

A status that indicates the system successfully generated a new frame.

[`SCFrameStatus.idle`](/documentation/ScreenCaptureKit/SCFrameStatus/idle)

A status that indicates the system didn’t generate a new frame because the display didn’t change.

[`SCFrameStatus.blank`](/documentation/ScreenCaptureKit/SCFrameStatus/blank)

A status that indicates the system didn’t generate a new frame because the display is blank.

[`SCFrameStatus.started`](/documentation/ScreenCaptureKit/SCFrameStatus/started)

A status that indicates the frame is the first one sent after the stream starts.

[`SCFrameStatus.suspended`](/documentation/ScreenCaptureKit/SCFrameStatus/suspended)

A status that indicates the system didn’t generate a new frame because you suspended updates.

[`SCFrameStatus.stopped`](/documentation/ScreenCaptureKit/SCFrameStatus/stopped)

A status that indicates the frame is in a stopped state.


---

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)